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	245950	October 10, 2026
Change icons globally Developer Guides how-to	26	10350	October 5, 2025
Message Format support for localization Developer Guides translation , reference	0	5265	May 31, 2013
Add custom content that only appears on your homepage Developer Guides how-to	10	8340	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	18165	October 11, 2018
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9315	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	12269	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29824	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	25	October 9, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32506	July 30, 2026
Get started with Theme Creator and the Theme CLI Developer Guides how-to , theme-creator , theme-guides	8	13247	May 7, 2026
Designer's Guide to getting started with themes in Discourse Developer Guides tutorial , theme-guides	9	12700	April 8, 2024
Developing Discourse Plugins - Part 6 - Add acceptance tests Developer Guides testing , plugin-guides , tutorial	32	17947	June 2, 2022
Developing Discourse Plugins - Part 5 - Add an admin interface Developer Guides plugin-guides , tutorial	46	27397	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	84538	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	2276	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	1111	October 5, 2023
Developing Discourse on GitHub Codespaces Developer Guides	14	2061	September 9, 2025
Creating a whisper post Site Management how-to , whispers	4	15112	July 23, 2025
Creating and configuring custom user fields Site Management how-to , user-custom-fields , users	25	18769	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	16577	January 7, 2026
Configure Discourse to use a separate PostgreSQL server Self-Hosting how-to	52	30504	October 3, 2026