Is there a single, comprehensive place where the various discourse settings are documented?

Nothing in particular right now. I’m setting up discourse for a client and they asked for some documentation on the ocean of settings.

Most of the settings that need to be tweaked are handled in the setup wizard for the site. Beyond that, there’s some tweaking you can do, but it shouldn’t always be necessary. If you’re hosted with us, don’t hesitate to send us an email if you need some assistance!

Mostly you can rely on defaults being sensible. Don’t go looking for trouble. :wink: A big help is knowing that the search searches the names, descriptions, and values of all those settings. If you don’t want to ask for free help here publicly, I and others are available at an hourly rate.

Hello Aaron, care to have a chat/call on this? I am currently looking at how we at Discourse can improve this, so any feedback you can offer is super welcome! EDIT And to speak to your question, each setting is documented within the setting itself, so you find text/notes/tooltips underneath the setting themselves explaining them, and each text in the description and the setting text itself is searchable, as we try to use descriptive keywords. So while there isn’t a documentation as you may have asked for, the description helps me and I use the Filter box to search through the settings to make sense of it. The filter box: [image] Searching through the tooltips to see if anything matches or deals with document… ation? [image] I hope this helps in a way of some sorts.

Comprehensive documentation for settings?

Product Support

justin (Justin DiRose) February 11, 2021, 6:10pm 2

There is not at this time - is there something in particular you’re looking for?

Topic		Replies	Views
Connecting site settings to documentation Feature site-settings	5	329	December 30, 2025
Documentation for all features of current Discourse? Product Support	1	175	November 27, 2025
More details for settings Feature	7	937	April 6, 2022
Some settings need better descriptions UX	7	827	January 17, 2022
The Evil Bouncy Castle of Settings and Customize UX	6	1501	April 10, 2024

Comprehensive documentation for settings?

Related topics