Documentation

Site Management Documentation covering the configuration, moderation, and ongoing management of your Discourse community - useful for site owners, administrators, and moderators. (Index) Using Discourse Topics showing how to Discourse by reading and writing content, and navigating Discourse sites. (Index) Hosted Customers Documentation and guides for people who run Discourse-hosted sites (Index) Contributing Guides on how to contribute to the Discourse open-source project. (Index) Integrations Documentation about connecting Discourse with other platforms and services. (Index) Self-Hosting Documentation and guides for people who self-host their Discourse sites. (Index) Migrating to Discourse Guides and advice on how to migrate your forum to Discourse. (Index) Developer Guides Documentation about extending Discourse with plugins, themes, and theme components, working with the core code, and using the Discourse API. (Index)

Topic	Replies	Views	Activity
Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver Self-Hosting email , how-to , advanced-setup , mail-receiver	72	48264	March 25, 2026
Redirect old forum URLs to new Discourse URLs using permalinks Migrating to Discourse how-to	10	29257	September 13, 2024
Composer Popup Messages Guide Site Management composer , explanation	8	736	March 24, 2026
Creating a banner to display at the top of your site Site Management how-to , customization	11	15579	January 7, 2026
Create a Data Explorer query using the API Integrations rest-api , data-explorer , how-to	2	91	March 24, 2026
Theme Developer Tutorial: 6. Using the JS API Developer Guides	3	889	April 14, 2025
Theme modifiers: A brief introduction Developer Guides theme-guides	20	4557	October 24, 2025
Use Discourse Core Variables in your Theme Developer Guides how-to , theme-guides	0	12007	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29143	April 12, 2017
Add a new provider to discourse-chat-integration Developer Guides how-to , plugin-guides	0	4657	August 16, 2017
Add a new locale from plugin Developer Guides how-to , plugin-guides	1	3361	June 11, 2019
Developing Discourse Plugins - Part 6 - Add acceptance tests Developer Guides testing , plugin-guides , tutorial	32	17215	June 2, 2022
Developing Discourse Plugins - Part 4 - Setup git Developer Guides plugin-guides , tutorial	10	13001	January 30, 2024
(not recommended) Overriding Discourse templates from a Theme or Plugin Developer Guides how-to	11	2560	July 26, 2024
Adding a new 'managed' authentication method to Discourse Developer Guides explanation	2	3594	November 29, 2023
Using the DModal API to render Modal windows (aka popups/dialogs) in Discourse Developer Guides code	1	2012	December 27, 2023
Developer's guide to Markdown extensions Developer Guides markdown , reference , code	0	13445	July 11, 2017
Set up Discourse for development on Fedora Linux Developer Guides dev-install , how-to	10	4328	November 12, 2025
Set up a local Discourse Development Environment? Developer Guides dev-install , how-to	0	8561	March 11, 2021
Install Discourse for development using Docker Developer Guides dev-install , docker , how-to	222	86402	February 7, 2026
Searching for content effectively Using Discourse search	4	3924	March 24, 2026
Discourse AI - Large Language Model (LLM) settings page Site Management ai , how-to	20	3065	November 26, 2025
Self-Hosting Sentiment and Emotion for DiscourseAI Self-Hosting ai-sentiment , ai	11	940	August 28, 2025
Configure API Keys for OpenAI Integrations ai , how-to	11	3531	November 11, 2024
Admin guide to tags in Discourse Site Management reference , tags	12	30823	March 22, 2026
Discourse AI - Periodic summary reports Site Management ai , automation , how-to	4	2173	March 20, 2026
Helper - captioning images Site Management ai-captions , how-to , ai	9	338	September 2, 2025
Using Discourse with Cloudflare: Best Practices Self-Hosting how-to , cloudflare	27	4587	March 20, 2026
Setup HubSpot chat Integration Integrations how-to	10	4228	June 17, 2025
Enable group sync from Google Workplace Integrations how-to , platforms	7	1601	April 11, 2025