# Documentation **URL:** https://meta.discourse.org/c/documentation/10.md?ascending=false&page=11 [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) **Page:** 12 --- ## [Moderation flags](https://meta.discourse.org/t/moderation-flags/325589)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 9, 2024, 6:04am UTC](https://meta.discourse.org/t/moderation-flags/325589 "2024-09-09T06:04:54Z")
:bookmark: This guide explains how to moderate and manage flags within Discourse, including system flags and custom flags, as well as actions required to add, reorder, or disable them. :person\_raising\_hand: Required us… --- ## [Calculating "Top" topics in Discourse](https://meta.discourse.org/t/calculating-top-topics-in-discourse/240928)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 2\ **Last updated:** [July 8, 2025, 3:13pm UTC](https://meta.discourse.org/t/calculating-top-topics-in-discourse/240928 "2025-07-08T15:13:53Z")
:bookmark: This is a reference guide explaining how topics filtered by “Top” are determined to be “Top Topics” in Discourse. :person\_raising\_hand: Required user level: All users Discourse sites have a feature that al… --- ## [Posting code or preformatted text](https://meta.discourse.org/t/posting-code-or-preformatted-text/188910)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [November 11, 2024, 9:26am UTC](https://meta.discourse.org/t/posting-code-or-preformatted-text/188910 "2024-11-11T09:26:14Z")
:bookmark: This guide explains how to post code or preformatted text in Discourse using Markdown, BBCode, and HTML formats. :person\_raising\_hand: Required user level: All users Have a line of code you need to share? … --- ## [Discourse AI - Summarize](https://meta.discourse.org/t/discourse-ai-summarize/262711)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 32\ **Last updated:** [June 5, 2025, 2:33pm UTC](https://meta.discourse.org/t/discourse-ai-summarize/262711 "2025-06-05T14:33:26Z")
:bookmark: This topic covers the configuration of the Summarize feature of the Discourse AI plugin. :person\_raising\_hand: Required user level: Administrator Summarize topics and chat channels for a quick recap. Use i… --- ## [Repackaging a markdown-it extension as a Discourse plugin](https://meta.discourse.org/t/repackaging-a-markdown-it-extension-as-a-discourse-plugin/84614)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [April 5, 2018, 2:05am UTC](https://meta.discourse.org/t/repackaging-a-markdown-it-extension-as-a-discourse-plugin/84614 "2018-04-05T02:05:44Z")
markdown.it the CommonMark engine used by Discourse has a wide array of plugins Header anchors, definition lists, smart-arrows and the list goes on and on. First a warning :warning: CommonMark is meant to be… Common. … --- ## [Pre-launch Checklist for Discourse Migrations](https://meta.discourse.org/t/pre-launch-checklist-for-discourse-migrations/357344)
**Author:** [@system](https://meta.discourse.org/u/system)\ **Replies:** 0\ **Last updated:** [March 14, 2025, 9:19pm UTC](https://meta.discourse.org/t/pre-launch-checklist-for-discourse-migrations/357344 "2025-03-14T21:19:26Z")
Before launching your Discourse community, we recommend taking some time to walk through this checklist. Migration projects are exciting but checking everything carefully now helps ensure a smooth experience for your mem… --- ## [Customizing your site with existing theme components](https://meta.discourse.org/t/customizing-your-site-with-existing-theme-components/312297)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 2\ **Last updated:** [June 11, 2025, 12:09pm UTC](https://meta.discourse.org/t/customizing-your-site-with-existing-theme-components/312297 "2025-06-11T12:09:24Z")
:bookmark: This guide introduces Discourse theme components, and how to use ready-made ones to customize your site :person\_raising\_hand: Required user level: Administrator Theme components are customizations that cha… --- ## [Adding a table to your post using markdown](https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 26\ **Last updated:** [June 9, 2025, 7:09pm UTC](https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544 "2025-06-09T19:09:30Z")
:bookmark: This guide explains how to add tables to your Discourse posts using Markdown. :person\_raising\_hand: Required user level: All users Adding tables to your posts can help present data in a structured and easy… --- ## [Making requests to Discourse using Monkedo](https://meta.discourse.org/t/making-requests-to-discourse-using-monkedo/367819)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 27, 2025, 7:09pm UTC](https://meta.discourse.org/t/making-requests-to-discourse-using-monkedo/367819 "2025-05-27T19:09:05Z")
:bookmark: This guide explains how to connect Discourse with over 400 applications using Monkedo, a no-code automation platform that allows you to create workflows between Discourse and other services. … --- ## [Preparing for and undertaking a platform migration](https://meta.discourse.org/t/preparing-for-and-undertaking-a-platform-migration/83824)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [March 26, 2018, 3:17am UTC](https://meta.discourse.org/t/preparing-for-and-undertaking-a-platform-migration/83824 "2018-03-26T03:17:51Z")
Migrating your community from one platform to another can be a daunting task. If you are planning a switch to Discourse, here are some tips to help things go as smoothly as possible. Early communication The biggest hur… --- ## [Restore a backup from the command line](https://meta.discourse.org/t/restore-a-backup-from-the-command-line/108034)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 18\ **Last updated:** [May 18, 2025, 10:22pm UTC](https://meta.discourse.org/t/restore-a-backup-from-the-command-line/108034 "2025-05-18T22:22:02Z")
:bookmark: This guide explains how to restore a Discourse backup from the command line without using the Discourse web UI. :person\_raising\_hand: Required user level: Administrator :wrench: Console access required He… --- ## [Discourse Public Data Dump](https://meta.discourse.org/t/discourse-public-data-dump/264748)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [May 13, 2025, 8:06am UTC](https://meta.discourse.org/t/discourse-public-data-dump/264748 "2025-05-13T08:06:23Z")
Given the advent of AI and the need for large datasets on local development machines, we have pulled together a quick pattern for getting a “workable” copy of all public (visible by anon) data from a Discourse forum. Ke… --- ## [Setting up the 'Append last checked by' automation](https://meta.discourse.org/t/setting-up-the-append-last-checked-by-automation/277110)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [May 6, 2025, 7:23pm UTC](https://meta.discourse.org/t/setting-up-the-append-last-checked-by-automation/277110 "2025-05-06T19:23:57Z")
:bookmark: This guide explains how to set up an Automation using the “Append last checked by” script. This feature automatically adds an interactive ‘checked by’ box to designated topics, showing when they were last rev… --- ## [Discourse AI - Self-Hosted Guide](https://meta.discourse.org/t/discourse-ai-self-hosted-guide/259598)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 59\ **Last updated:** [May 20, 2024, 3:05am UTC](https://meta.discourse.org/t/discourse-ai-self-hosted-guide/259598 "2024-05-20T03:05:46Z")
This is a guide aimed at running your own instances of the services that power Discourse AI modules. Introduction If you want to use Discourse AI on your self-hosted instance, you may need to also run the companion s… --- ## [Mirroring a read-only mailing list in Discourse](https://meta.discourse.org/t/mirroring-a-read-only-mailing-list-in-discourse/77990)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 12\ **Last updated:** [April 29, 2025, 4:06am UTC](https://meta.discourse.org/t/mirroring-a-read-only-mailing-list-in-discourse/77990 "2025-04-29T04:06:37Z")
:bookmark: This guide explains how to create a read-only mirror of a mailing list using Discourse. It covers the necessary site settings, category configuration, and subscription process. :person\_raising\_hand: Required… --- ## [Understanding user interface elements in Discourse](https://meta.discourse.org/t/understanding-user-interface-elements-in-discourse/103351)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 8\ **Last updated:** [May 11, 2024, 11:40am UTC](https://meta.discourse.org/t/understanding-user-interface-elements-in-discourse/103351 "2024-05-11T11:40:38Z")
:bookmark: This resource covers the names for each element of the Discourse user interface. :person\_raising\_hand: Required user level: All users Here’s what Discourse’s interface looks like most of the time. Themes, … --- ## [Self-Hosting Embeddings for DiscourseAI](https://meta.discourse.org/t/self-hosting-embeddings-for-discourseai/290925)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 21\ **Last updated:** [April 14, 2025, 9:02pm UTC](https://meta.discourse.org/t/self-hosting-embeddings-for-discourseai/290925 "2025-04-14T21:02:08Z")
The Discourse AI plugin has many features that require embeddings to work, such as Related Topics, AI Search, AI Helper Category and Tag suggestion, etc. While you can use a third-party API, like Configure API Keys for O… --- ## [Do you offer migrations services?](https://meta.discourse.org/t/do-you-offer-migrations-services/306422)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 2, 2024, 1:14am UTC](https://meta.discourse.org/t/do-you-offer-migrations-services/306422 "2024-05-02T01:14:44Z")
:bookmark: This document explains the migration services offered to customers on Business and Enterprise hosting plans, including what’s covered and the payment requirements. :person\_raising\_hand: Required user level: … --- ## [What are the Terms of Service for Discourse Hosting?](https://meta.discourse.org/t/what-are-the-terms-of-service-for-discourse-hosting/306411)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 1, 2024, 11:32pm UTC](https://meta.discourse.org/t/what-are-the-terms-of-service-for-discourse-hosting/306411 "2024-05-01T23:32:04Z")
:bookmark: This document provides the locations of the current Terms of Service documents for Discourse Hosting. :person\_raising\_hand: Required user level: All users Summary Discourse offers different hosting option… --- ## [Cleaning up uploads and purging uploads from S3](https://meta.discourse.org/t/cleaning-up-uploads-and-purging-uploads-from-s3/248343)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 2\ **Last updated:** [December 24, 2024, 8:08am UTC](https://meta.discourse.org/t/cleaning-up-uploads-and-purging-uploads-from-s3/248343 "2024-12-24T08:08:17Z")
:bookmark: This is a reference guide describing how orphaned and deleted uploads are automatically purged from a Discourse site. This guide applies to both self-hosted and hosted Discourse sites. :person\_raising\_hand: … --- ## [Configuring group notifications for a private category](https://meta.discourse.org/t/configuring-group-notifications-for-a-private-category/96424)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [March 21, 2025, 4:57pm UTC](https://meta.discourse.org/t/configuring-group-notifications-for-a-private-category/96424 "2025-03-21T16:57:21Z")
:bookmark: This guide explains how to set up a group to receive notifications and emails for a private category in Discourse. :person\_raising\_hand: Required user level: Administrator This guide will walk you through … --- ## [Promoting a User to Admin or Moderator Status](https://meta.discourse.org/t/promoting-a-user-to-admin-or-moderator-status/284754)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 10\ **Last updated:** [March 20, 2025, 10:14pm UTC](https://meta.discourse.org/t/promoting-a-user-to-admin-or-moderator-status/284754 "2025-03-20T22:14:32Z")
:discourse: This is a how-to guide intended to help existing site admins understand how to promote a user to admin or moderator status through Discourse. :person\_raising\_hand: Required user level: Administrator Admin… --- ## [Theme Developer Tutorial: 3. CSS in Themes](https://meta.discourse.org/t/theme-developer-tutorial-3-css-in-themes/357798)
**Author:** [@system](https://meta.discourse.org/u/system)\ **Replies:** 5\ **Last updated:** [March 18, 2025, 11:50pm UTC](https://meta.discourse.org/t/theme-developer-tutorial-3-css-in-themes/357798 "2025-03-18T23:50:32Z")
Technically, Discourse uses SCSS to author its stylesheets. However, we’re increasingly moving towards native CSS features as they mature, so the vast majority of themes won’t need to use SCSS features or syntaxes. We fo… --- ## [Developing Discourse Themes & Theme Components](https://meta.discourse.org/t/developing-discourse-themes-theme-components/93648)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 14\ **Last updated:** [March 18, 2025, 11:33pm UTC](https://meta.discourse.org/t/developing-discourse-themes-theme-components/93648 "2025-03-18T23:33:05Z")
Discourse Themes and Theme Components can be used to customize the look, feel and functionality of Discourse’s frontend. This section of the developer guides aims to provide all the reference materials you need to develo… --- ## [Theme Developer Tutorial: 5. Building and using components](https://meta.discourse.org/t/theme-developer-tutorial-5-building-and-using-components/357800)
**Author:** [@system](https://meta.discourse.org/u/system)\ **Replies:** 0\ **Last updated:** [March 18, 2025, 3:59pm UTC](https://meta.discourse.org/t/theme-developer-tutorial-5-building-and-using-components/357800 "2025-03-18T15:59:11Z")
In the last chapter, we explored how you can render Glimmer Components into plugin outlets, and moved our CustomWelcomeBanner component into its own file. In this chapter, we’ll extend the functionality of the banner to … --- ## [Theme Developer Tutorial: 4. Using Outlets to insert and replace content](https://meta.discourse.org/t/theme-developer-tutorial-4-using-outlets-to-insert-and-replace-content/357799)
**Author:** [@system](https://meta.discourse.org/u/system)\ **Replies:** 0\ **Last updated:** [March 18, 2025, 3:59pm UTC](https://meta.discourse.org/t/theme-developer-tutorial-4-using-outlets-to-insert-and-replace-content/357799 "2025-03-18T15:59:10Z")
Discourse uses the Ember JS Framework for its user interface. On top of Ember, Discourse provides a number of APIs to allow themes to customize the user interface. The most commonly-used API is Plugin Outlets. These out… --- ## [Developing Discourse Plugins - Part 3 - Add custom site settings](https://meta.discourse.org/t/developing-discourse-plugins-part-3-add-custom-site-settings/31115)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 39\ **Last updated:** [March 15, 2025, 11:08pm UTC](https://meta.discourse.org/t/developing-discourse-plugins-part-3-add-custom-site-settings/31115 "2025-03-15T23:08:09Z")
Previous tutorial: Developing Discourse Plugins - Part 2 - Connect to a plugin outlet Site Settings If you visit /admin/site\_settings on a Discourse you have administrator capabilities on, you’ll see a list of configur… --- ## [Make staff users more recognizable with customized avatars, posts, and mentions](https://meta.discourse.org/t/make-staff-users-more-recognizable-with-customized-avatars-posts-and-mentions/142794)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [March 15, 2025, 6:21am UTC](https://meta.discourse.org/t/make-staff-users-more-recognizable-with-customized-avatars-posts-and-mentions/142794 "2025-03-15T06:21:42Z")
There are various methods that can be used to make a staff user immediately recognizable to other users. Show moderator shield Any staff user who is moderator, or admin and moderator, will have the moderator shield nex… --- ## [Set up Discord notifications with the discourse-chat-integration plugin](https://meta.discourse.org/t/set-up-discord-notifications-with-the-discourse-chat-integration-plugin/66600)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 63\ **Last updated:** [February 26, 2025, 12:41am UTC](https://meta.discourse.org/t/set-up-discord-notifications-with-the-discourse-chat-integration-plugin/66600 "2025-02-26T00:41:55Z")
:bookmark: This guide explains how to configure Discord notifications for your Discourse forum using the discourse-chat-integration plugin. This plugin is included with Discourse — no separate installation is required. … --- ## [Adding information about the flag review process](https://meta.discourse.org/t/adding-information-about-the-flag-review-process/352008)
**Author:** [@system](https://meta.discourse.org/u/system)\ **Replies:** 0\ **Last updated:** [February 14, 2025, 2:45am UTC](https://meta.discourse.org/t/adding-information-about-the-flag-review-process/352008 "2025-02-14T02:45:11Z")
:bookmark: This is a how-to guide on how to modify information about the flags review process. :person\_raising\_hand: Required user level: Admin At the top of the flag modal generic information about the review proces… [Previous page](https://meta.discourse.org/c/documentation/10.md?ascending=false&page=10) [Next page](https://meta.discourse.org/c/documentation/10.md?ascending=false&page=12)