Please update 'Understanding Discourse Trust Levels' — or is there a different doc?

[Canapin (Coin-coin le Canapin)]

I suggest you replace “private message” by “direct message” and “PM” by “DM”.

[JammyDodger]

I’ve gone with updating the ‘Private Messages’ one to ‘Can send Personal Messages’, to mirror the current language. I don’t think they’re referred to as Direct Messages in the settings anywhere, so that change would have to be done at source.

[Canapin (Coin-coin le Canapin)]

I thought Direct message was the official name for the “Private messages”, but they seem to be called personal messages. Is that a recent change?

---

edit: oh, maybe it’s because it’s called “message direct” in French.

[justin (Justin DiRose)]

@JammyDodger this is incredible work. I’ll add this to the post soon!

[mattdm (Matthew Miller)]

@Canapin

However, the black checkmarks are hard to distinguish on the dark theme:

*cough* RFE: dark/light mode options for custom emoji

[mattdm (Matthew Miller)]

Anyway, this is amazing. Thank you @JammyDodger!

Oh! I do have one suggestion. Some of these things are changeable via settings in the admin interface. Might be nice to have those things indicated differently in the chart? That would make it easier for those of us who might have ^[1] changed some of those to make our own site-specific version.

---

1. and by “might have”, I mean “definitely have” ↩︎

[JammyDodger]

I tried to be super-swish and add a placeholder to add a domain and turn all the names into site-specific admin settings links, but it did not seem to like that. The perfect one would be dynamic to your own current settings, but unfortunately I do not know how to do that either… (open to suggestions )

But I think the gear icon could be given a column to show which are configurable. I’ll give it a whirl.

[JammyDodger]

I’ve done an excerpt as a tester. How do people feel about something like this?

Draft Grid

Under construction!

Trust Level Grid - Defaults

TL = Trust Level dependant | = Enabled by admin setting

	Post Actions	TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[1]	Post Replies	10					TL
[2]	Post Topics	3					TL
	Reply as Linked Topic						TL
[3]	Email-in New Topics						TL
[4]	Access Shared Drafts
[5]	Post Images	1					TL
[6]	Post Hyperlinks	2					TL
[7]	Mention users in a post	2					TL
[8]	Use @here Mention						TL
[9]	Post Attachments						TL
[10]	Create Polls						TL
	Close Any Poll
[11]	Edit Post Time	24 hrs	24 hrs	30 days	30 days	no limit	TL	no limit
[12]	Edit Wikis						TL
[13]	Make their own posts into Wikis						TL
[14]	Edit all Posts
[15]	Delete Own Posts (not Topics, unless there are no replies)
	Delete Other User’s Posts
	View Deleted Posts
[16]	Anonymous Posting						TL
	Rebuild HTML						TL
	Add Staff Notice
	Add Staff Colour
	Lock Post

---

1. max_replies_in_first_day
   newuser_max_replies_per_topic ↩︎

2. max_topics_in_first_day
   min_trust_to_create_topic ↩︎

3. email_in
   email_in_min_trust ↩︎

4. shared_drafts_category ↩︎

5. newuser_max_embedded_media ↩︎

6. newuser_max_links ↩︎

7. enable_mentions
   newuser_max_mentions_per_post
   max_mentions_per_post ↩︎

8. min_trust_level_for_here_mention ↩︎

9. new_user_max_attachments ↩︎

10. poll_minimum_trust_level_to_create ↩︎

11. min_trust_to_edit_post
    post_edit_time_limit
    tl2_post_edit_time_limit ↩︎

12. min_trust_to_edit_wiki ↩︎

13. min_trust_to_allow_self_wiki ↩︎

14. trusted_users_can_edit_others (?) ↩︎

15. max_post_deletions_per_day ↩︎

16. allow_anonymous_posting ↩︎

[mattdm (Matthew Miller)]

Yeah, that works. Clever use of footnotes!

[JammyDodger]

Excellent. I shall work through and add the rest.

I think we’ll need a pared-down version for the blog, with maybe no settings, cat mod, or mod comparison, to allow people to focus on the 5 main user trust levels, and then have a more detailed one as a #howto:faq here on Meta.

I’ll also take the chance to float the idea of a Cut-Out-And-Keep one that you can copy and paste into a Staff topic on your own forum. This one has interactive links for the admin settings:

Draft Grid

Excerpt - under construction!

## Trust Level Grid - Defaults
TL = Trust Level dependant  | :gear: = Enabled by admin setting

:gear: | [u] Post Actions [/u] | TL0 | TL1 | TL2 | TL3 | TL4 | Category<br>Moderator | Moderator
:-:|-|:-:|:-:|:-:|:-:|:-:| :-: | :-:
[^1] | Post Replies | 10 | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  |:white_check_mark: | TL | :white_check_mark: 
 [^2] | Post Topics | 3 | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark: | TL | :white_check_mark: 
&emsp; | Reply as Linked Topic | | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark: | TL | :white_check_mark: 
 [^3] | Email-in New Topics <sup> :gear:  | |   | :white_check_mark:  | :white_check_mark:  | :white_check_mark: | TL | :white_check_mark: 
 [^4] | Access Shared Drafts | | | | | | | :white_check_mark: 
 [^5] | Post Images | 1 | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
 [^6] | Post Hyperlinks | 2 | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
 [^7] | Mention users in a post | 2 | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
 [^8] | Use @here Mention | |  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
  [^9] | Post Attachments |  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark:
 [^10] | Create Polls | | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
&emsp; | Close Any Poll | | |||  | | :white_check_mark:  | 
 [^11] |Edit Post Time | 24<br>hrs | 24<br>hrs | 30<br>days | 30<br>days | no<br>limit | TL | no<br>limit
 [^12] |Edit Wikis | | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark:  | TL | :white_check_mark: 
 [^13] | Make their own posts into Wikis |  |  |  | :white_check_mark:  | :white_check_mark:  | TL | :white_check_mark: 
 [^14] | Edit all Posts |  |  |  |  | :white_check_mark:  | :white_check_mark: | :white_check_mark: 
 [^15] | Delete Own Posts (not Topics, unless there are no replies) |  :white_check_mark: | :white_check_mark:  |  :white_check_mark:  | :white_check_mark:  | :white_check_mark:  | :white_check_mark: | :white_check_mark: 
&emsp; | Delete Other User's Posts | |  |  |  |  | :white_check_mark:  | :white_check_mark: | :white_check_mark: 
&emsp; | View Deleted Posts  | | | | | | :white_check_mark: |:white_check_mark: 
 [^16] |Anonymous Posting :gear:  | | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | TL | :white_check_mark: 
&emsp; | Rebuild HTML | |  |  |  | :white_check_mark:  | TL | :white_check_mark: 
&emsp; | Add Staff Notice |  |  |  |  | :white_check_mark:  | :white_check_mark: | :white_check_mark: 
&emsp;  |Add Staff Colour | | | | | | |:white_check_mark: 
&emsp;  | Lock Post  | | | | | | |:white_check_mark: 

[^1]: [max_replies_in_first_day](/admin/site_settings/category/all_results?filter=max_replies_in_first_day)<br>[newuser_max_replies_per_topic](/admin/site_settings/category/all_results?filter=newuser_max_replies_per_topic)
[^2]: [max_topics_in_first_day](/admin/site_settings/category/all_results?filter=max_topics_in_first_day)<br>[min_trust_to_create_topic](/admin/site_settings/category/all_results?filter=max_topics_in_first_day)
[^3]: [email_in](/admin/site_settings/category/all_results?filter=email_in)<br>[email_in_min_trust](/admin/site_settings/category/all_results?filter=email_in_min_trust)
[^4]: [shared_drafts_category](/admin/site_settings/category/all_results?filter=shared_drafts_category)<br>[shared_drafts_min_trust_level](/admin/site_settings/category/all_results?filter=shared_drafts_min_trust_level)
[^5]: [newuser_max_embedded_media](/admin/site_settings/category/all_results?filter=newuser_max_embedded_media)
[^6]: [newuser_max_links](/admin/site_settings/category/all_results?filter=newuser_max_links)
[^7]: [enable_mentions](/admin/site_settings/category/all_results?filter=enable_mentions)<br>[newuser_max_mentions_per_post](/admin/site_settings/category/all_results?filter=newuser_max_mentions_per_post)<br>[max_mentions_per_post](/admin/site_settings/category/all_results?filter=max_mentions_per_post)
[^8]: [min_trust_level_for_here_mention](/admin/site_settings/category/all_results?filter=min_trust_level_for_here_mention)
[^9]: [new_user_max_attachments](/admin/site_settings/category/all_results?filter=new_user_max_attachments)
[^10]: [poll_minimum_trust_level_to_create](/admin/site_settings/category/all_results?filter=poll_minimum_trust_level_to_create)
[^11]: [min_trust_to_edit_post](/admin/site_settings/category/all_results?filter=min_trust_to_edit_post)<br>[post_edit_time_limit](/admin/site_settings/category/all_results?filter=post_edit_time_limit)<br>[tl2_post_edit_time_limit](/admin/site_settings/category/all_results?filter=tl2_post_edit_time_limit)
[^12]: [min_trust_to_edit_wiki](/admin/site_settings/category/all_results?filter=min_trust_to_edit_wiki)
[^13]: [min_trust_to_allow_self_wiki](/admin/site_settings/category/all_results?filter=min_trust_to_allow_self_wiki)
[^14]: [trusted_users_can_edit_others](/admin/site_settings/category/all_results?filter=trusted_users_can_edit_others)
[^15]: [max_post_deletions_per_day](/admin/site_settings/category/all_results?filter=max_post_deletions_per_day)
[^16]: [allow_anonymous_posting](/admin/site_settings/category/all_results?filter=allow_anonymous_posting)

[JammyDodger]

Here’s the latest draft of what will be the FAQ Version. I think it’s pretty close to the final version, but if anyone can spot any errors or omissions please shout out.

Draft Grid

Trust Level Grid - Defaults

TL = Trust Level dependant
= Can be enabled or adjusted by an admin setting

		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[1]	Post Replies						TL
[2]	Post Topics						TL
	Reply as Linked Topic						TL
[3]	Reply by email						TL
[4]	Email-in New Topics						TL
[5]	Post Attachments						TL
[6]	Post Images	1					TL
[7]	Post Links	2					TL
[8]	Mention users in a post	2					TL
[9]	Use @here Mention						TL
[10]	Tag a Topic						TL
[11]	Create Tags						TL
[12]	Create Polls						TL
	Close Any Poll
[13]	Edit Posts	24 hrs	24 hrs	30 days	30 days	no limit	TL	no limit
[14]	Edit Wikis						TL
[15]	Make their own posts into Wikis						TL
[16]	Edit all Posts
[17]	Delete Own Posts (not Topics, unless there are no replies)
	Delete Other User’s Posts
	View Deleted Posts
[18]	Anonymous Posting						TL
[19]	Access Shared Drafts
[20]	See and Use Staff Whispers
		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[21]	Daily Like Limit/Multiplier	50	50	x1.5	x2	x3	TL	No Limit
[22]	Upload Avatar						TL
[23]	Profile Background						TL
[24]	Usercard Background						TL
	Mute other users						TL
[25]	Ignore other users						TL
[26]	View New User Post Messages						TL
[27]	View Returning User Post Messages						TL
	Have actual links in the ‘about me’ field of their profile						TL
[28]	Have all their links followed (automatic nofollow removed)						TL
[29]	Access the Lounge						TL
[30]	Have Shield Icon
	Manage Users Can view user info Can update user’s preferences Can adjust a user’s trust level							✓ ✓ ✓
		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[31]	Flag Posts						TL
[32]	Can hide TL0 spam posts						TL
[33]	Flags count towards auto-supressing TL0 spammers						TL
[34]	Flagging a post immediately takes effect and hides the target post
	Review Posts and Flags
	Silence or Suspend Users
	Anonymize or Delete Users
		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[35]	Can send Personal Messages						TL
[36]	Invite outside users to PMs making a group PM						TL
[37]	Invite people to specific topics						TL
[38]	Can send personal messages to an email address						TL
		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[39]	Re-categorize and rename topics						TL/Category
	Rebuild HTML						TL
	Add Staff Notice
	Add Staff Colour
	Lock Post
	Split and Merge Topics
	Delete Topic
	Pin/Unpin Topic  Pin Topic  Pin Topic Globally  Make Banner					✓ ✓	✓ TL	✓ ✓ ✓
	Close Topics
	Archive Topics
	Make Topics Unlisted
	See Unlisted Topics in Topic List
	Reset Topic Bump Date
	Set Topic Timer  Auto-Close Topic  Auto-Close Topic After Last Post  Auto-Bump Topic  Close Temporarily  Schedule Publishing  Auto-Delete Topic  Auto-Delete Replies					✓ ✓ ✓ ✓ ✓	TL TL TL TL TL TL	✓ ✓ ✓ ✓ ✓ ✓ ✓
	Change Timestamp
	Make Personal Message/Public Topic
	Moderation History
		TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
	Edit Catgory Descriptions
	Watched Words
	View Logs (Staff Actions, Screened Emails, Screened IPs, Screened URLs, Search Logs)
	View Dashboard (no upgrade option)
[40]	Allow moderators to create and manage categories and groups
[41]	Allow moderators to change post ownership
[42]	Allow moderators to view user emails
	Plugins	TL0	TL1	TL2	TL3	TL4	Category Moderator	Moderator
[43]	Mark Solutions (discourse-solved)						TL
[44]	Vote Limit (discourse-voting)	2	4	6	8	10
[45]	Endorsements (discourse-category-experts)	1	1	x2	x2	x3

---

1. max replies in first day
   newuser max replies per topic ↩︎

2. max topics in first day
   min trust to create topic ↩︎

3. reply by email enabled ↩︎

4. email in
   email in min trust ↩︎

5. newuser max attachments ↩︎

6. newuser max embedded media
   min trust to post embedded media
   review media unless trust level ↩︎

7. newuser max links
   min trust to post links ↩︎

8. enable mentions
   newuser max mentions per post
   max mentions per post ↩︎

9. min trust level for here mention ↩︎

10. tagging enabled
    min trust level to tag topics ↩︎

11. min trust to create tag ↩︎

12. poll minimum trust level to create ↩︎

13. min trust to edit post
    post edit time limit
    tl2 post edit time limit
    additional edits per day multiplier ↩︎

14. min trust to edit wiki ↩︎

15. min trust to allow self wiki ↩︎

16. trusted users can edit others ↩︎

17. max post deletions per day
    max post deletions per minute ↩︎

18. allow anonymous posting ↩︎

19. shared drafts category
    shared drafts min trust level ↩︎

20. enable whispers ↩︎

21. max likes per day
    additonal likes per day multiplier
    staff like weight ↩︎

22. allow uploaded avatars
    automatically download gravatars ↩︎

23. min trust level to allow profile background ↩︎

24. min trust level to allow user card background ↩︎

25. min trust level to allow ignore ↩︎

26. new user notice tl ↩︎

27. returning user notice tl ↩︎

28. tl3 links no follow ↩︎

29. /c/lounge/edit/security ↩︎

30. How to make a staff user more recognizable ↩︎

31. min trust to flag posts
    allow flagging staff
    additional flags per day multiplier ↩︎

32. high trust flaggers auto hide posts ↩︎

33. num users to silence new user
    silence new user sensitivity ↩︎

34. hide post sensitivity ↩︎

35. enable personal messages
    min trust to send messages
    max personal messages per day ↩︎

36. min trust level to allow invite ↩︎

37. min trust level to allow invite ↩︎

38. min trust to send email messages ↩︎

39. trusted users can edit others ↩︎

40. moderators manage categories and groups ↩︎

41. moderators change post ownership ↩︎

42. moderators view emails ↩︎

43. accept all solutions trust level ↩︎

44. vote limit ↩︎

45. max category expert endorsements per day
    additional category expert endorsements per day multiplier ↩︎

[Canapin (Coin-coin le Canapin)]

What’s the difference between a cell with and a cell with nothing?

[JammyDodger]

Nothing. I think I put the in for emphasis, and to provide a bit of shape to the ‘mini-sections’. Let’s try taking them out and see if it works better/is more consistent.

Edit: Any better?

[Canapin (Coin-coin le Canapin)]

I do think that’s slightly better.

And I like this table.

[justin (Justin DiRose)]

The table is now added to the blog post! We’re working on fixing the styling, so hang tight on that.

[tobiaseigen]

I love charts like this, and I love this chart! So… well done!

[JammyDodger]

Now the TL0-TL4 one is on the blog it’s probably time to calve off the admin setting one into its own faq. I shall go and do that now. (I’ll also tuck the draft grids in this topic into details sections so as to not be too confusing for anyone reading this later)

And the topic is now here: Trust Level Permissions Table (inc Moderator Roles)

[Moin]

I think now there is no need for the link to the other table, which is shown in the topic of the blogpost before you press show full post, anymore.

[justin (Justin DiRose)]

I made a change here – the table in the post was a bit… clunky (especially on mobile). Instead, I’ve linked to the topic @JammyDodger created. That will be the source of truth for up to date/accurate permissions listing for TLs.

Thanks all for bringing this up!