Documentation

Self-Hosting Documentation and guides for people who self-host their Discourse sites. (Index) Contributing Guides on how to contribute to the Discourse open-source project. (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
Change icons globally Developer Guides how-to	26	10341	October 5, 2025
Message Format support for localization Developer Guides translation , reference	0	5262	May 31, 2013
Add custom content that only appears on your homepage Developer Guides how-to	10	8338	February 29, 2024
Create and share a font theme component Developer Guides how-to , theme-guides	4	6172	August 19, 2025
Insert text or images anywhere on your site using CSS pseudo-elements Developer Guides how-to , customization	0	18162	October 11, 2018
Replace Discourse's default SVG icons with custom icons in a theme Developer Guides how-to , theme-guides	10	9312	February 24, 2026
Include assets (e.g. images, fonts) in themes and components Developer Guides how-to , theme-guides	1	16207	August 23, 2024
Add localizable strings to themes and theme components Developer Guides how-to , theme-guides	22	5902	August 9, 2024
Use Discourse Core Variables in your Theme Developer Guides how-to , theme-guides	0	12267	January 9, 2018
Structure of themes and theme components Developer Guides reference , theme-guides	0	29818	April 12, 2017
The UI kit of shared Discourse components, helpers, and modifiers Developer Guides	0	147	August 31, 2026
Private modules and the `-internals` convention Developer Guides	0	19	October 9, 2026
Install the Discourse Theme CLI console app to help you build themes Developer Guides how-to , theme-guides	16	32493	July 30, 2026
Get started with Theme Creator and the Theme CLI Developer Guides how-to , theme-creator , theme-guides	8	13243	May 7, 2026
Designer's Guide to getting started with themes in Discourse Developer Guides tutorial , theme-guides	9	12696	April 8, 2024
Developing Discourse Plugins - Part 6 - Add acceptance tests Developer Guides testing , plugin-guides , tutorial	32	17940	June 2, 2022
Developing Discourse Plugins - Part 5 - Add an admin interface Developer Guides plugin-guides , tutorial	46	27389	September 24, 2024
Developing Discourse Plugins - Part 4 - Setup git Developer Guides plugin-guides , tutorial	10	13374	January 30, 2024
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	84523	July 8, 2025
Write end-to-end system specs for the Discourse user interface Developer Guides	3	766	August 28, 2025
Using the DModal API to render Modal windows (aka popups/dialogs) in Discourse Developer Guides code	0	2274	July 3, 2023
Setup Continuous Integration using GitHub Actions Developer Guides how-to , code	8	1732	March 3, 2025
Using Google's 'tachometer' to measure JS performance changes in Discourse Developer Guides code	0	1106	October 5, 2023
Developing Discourse on GitHub Codespaces Developer Guides	14	2058	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	18762	April 8, 2026
Adding a new 'managed' authentication method to Discourse Developer Guides explanation	2	3857	November 29, 2023
Creating a banner to display at the top of your site Site Management how-to , customization	11	16574	January 7, 2026
Configure Discourse to use a separate PostgreSQL server Self-Hosting how-to	52	30500	October 3, 2026
Objects type for theme setting Developer Guides how-to , theme-guides	32	2625	April 13, 2026