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 a supported tracking branch to get Discourse software updates Self-Hosting how-to	1	13052	March 26, 2026
Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver Self-Hosting email , how-to , advanced-setup , mail-receiver	77	48298	March 26, 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	738	March 24, 2026
Creating a banner to display at the top of your site Site Management how-to , customization	11	15586	January 7, 2026
Create a Data Explorer query using the API Integrations rest-api , data-explorer , how-to	2	94	March 24, 2026
Theme Developer Tutorial: 6. Using the JS API Developer Guides	3	890	April 14, 2025
Theme modifiers: A brief introduction Developer Guides theme-guides	20	4558	October 24, 2025
Use Discourse Core Variables in your Theme Developer Guides how-to , theme-guides	0	12008	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29144	April 12, 2017
Add a new provider to discourse-chat-integration Developer Guides how-to , plugin-guides	0	4658	August 16, 2017
Add a new locale from plugin Developer Guides how-to , plugin-guides	1	3362	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	86412	February 7, 2026
Searching for content effectively Using Discourse search	4	3926	March 24, 2026
Discourse AI - Large Language Model (LLM) settings page Site Management ai , how-to	20	3069	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	3532	November 11, 2024
Admin guide to tags in Discourse Site Management reference , tags	12	30825	March 22, 2026
Discourse AI - Periodic summary reports Site Management ai , automation , how-to	4	2175	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	4592	March 20, 2026
Setup HubSpot chat Integration Integrations how-to	10	4228	June 17, 2025