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
Contributing translations to Discourse Contributing translation , how-to	22	23685	October 11, 2026
Invite users to a group Site Management groups , how-to , invites	3	245978	October 10, 2026
Change icons globally Developer Guides how-to	26	10374	October 5, 2025
Message Format support for localization Developer Guides translation , reference	0	5286	May 31, 2013
Add custom content that only appears on your homepage Developer Guides how-to	10	8362	February 29, 2024
Create and share a font theme component Developer Guides how-to , theme-guides	4	6196	August 19, 2025
Insert text or images anywhere on your site using CSS pseudo-elements Developer Guides how-to , customization	0	18188	October 11, 2018
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9339	February 24, 2026
Include assets (e.g. images, fonts) in themes and components Developer Guides how-to , theme-guides	1	16210	August 23, 2024
Add localizable strings to themes and theme components Developer Guides how-to , theme-guides	22	5908	August 9, 2024
Use Discourse Core Variables in your Theme Developer Guides how-to , theme-guides	0	12270	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29825	April 12, 2017
The UI kit of shared Discourse components, helpers, and modifiers Developer Guides	0	151	August 31, 2026
Private modules and the `-internals` convention Developer Guides	0	26	October 9, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32513	July 30, 2026
Get started with Theme Creator and the Theme CLI Developer Guides how-to , theme-creator , theme-guides	8	13248	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	17950	June 2, 2022
Developing Discourse Plugins - Part 5 - Add an admin interface Developer Guides plugin-guides , tutorial	46	27403	September 24, 2024
Developing Discourse Plugins - Part 4 - Setup git Developer Guides plugin-guides , tutorial	10	13377	January 30, 2024
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	84541	July 8, 2025
Write end-to-end system specs for the Discourse user interface Developer Guides	3	768	August 28, 2025
Using the DModal API to render Modal windows (aka popups/dialogs) in Discourse Developer Guides code	0	2278	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	1112	October 5, 2023
Developing Discourse on GitHub Codespaces Developer Guides	14	2065	September 9, 2025
Creating a whisper post Site Management how-to , whispers	4	15118	July 23, 2025
Creating and configuring custom user fields Site Management how-to , user-custom-fields , users	25	18773	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	16578	January 7, 2026