Documentation

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

Topic	Replies	Views	Activity
Invite users to a group Site Management groups , how-to , invites	3	245946	October 10, 2026
Change icons globally Developer Guides how-to	26	10345	October 5, 2025
Message Format support for localization Developer Guides translation , reference	0	5264	May 31, 2013
Add custom content that only appears on your homepage Developer Guides how-to	10	8339	February 29, 2024
Create and share a font theme component Developer Guides how-to , theme-guides	4	6173	August 19, 2025
Insert text or images anywhere on your site using CSS pseudo-elements Developer Guides how-to , customization	0	18163	October 11, 2018
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9314	February 24, 2026
Include assets (e.g. images, fonts) in themes and components Developer Guides how-to , theme-guides	1	16208	August 23, 2024
Add localizable strings to themes and theme components Developer Guides how-to , theme-guides	22	5905	August 9, 2024
Use Discourse Core Variables in your Theme Developer Guides how-to , theme-guides	0	12268	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29821	April 12, 2017
The UI kit of shared Discourse components, helpers, and modifiers Developer Guides	0	148	August 31, 2026
Private modules and the `-internals` convention Developer Guides	0	22	October 9, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32501	July 30, 2026
Get started with Theme Creator and the Theme CLI Developer Guides how-to , theme-creator , theme-guides	8	13246	May 7, 2026
Designer's Guide to getting started with themes in Discourse Developer Guides tutorial , theme-guides	9	12699	April 8, 2024
Developing Discourse Plugins - Part 6 - Add acceptance tests Developer Guides testing , plugin-guides , tutorial	32	17943	June 2, 2022
Developing Discourse Plugins - Part 5 - Add an admin interface Developer Guides plugin-guides , tutorial	46	27395	September 24, 2024
Developing Discourse Plugins - Part 4 - Setup git Developer Guides plugin-guides , tutorial	10	13376	January 30, 2024
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	84529	July 8, 2025
Write end-to-end system specs for the Discourse user interface Developer Guides	3	767	August 28, 2025
Using the DModal API to render Modal windows (aka popups/dialogs) in Discourse Developer Guides code	0	2275	July 3, 2023
Setup Continuous Integration using GitHub Actions Developer Guides how-to , code	8	1733	March 3, 2025
Using Google's 'tachometer' to measure JS performance changes in Discourse Developer Guides code	0	1109	October 5, 2023
Developing Discourse on GitHub Codespaces Developer Guides	14	2060	September 9, 2025
Creating a whisper post Site Management how-to , whispers	4	15111	July 23, 2025
Creating and configuring custom user fields Site Management how-to , user-custom-fields , users	25	18767	April 8, 2026
Adding a new 'managed' authentication method to Discourse Developer Guides explanation	2	3860	November 29, 2023
Creating a banner to display at the top of your site Site Management how-to , customization	11	16575	January 7, 2026
Configure Discourse to use a separate PostgreSQL server Self-Hosting how-to	52	30501	October 3, 2026