# Documentation **URL:** https://meta.discourse.org/c/documentation/10.md?page=2&search=search [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) **Page:** 3 --- ## [Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso)](https://meta.discourse.org/t/setup-discourseconnect-official-single-sign-on-for-discourse-sso/13045)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 46\ **Last updated:** [May 27, 2026, 3:47am UTC](https://meta.discourse.org/t/setup-discourseconnect-official-single-sign-on-for-discourse-sso/13045 "2026-05-27T03:47:22Z")
DiscourseConnect is a core Discourse feature that allows you to configure “Single Sign-On (SSO)” to completely outsource all user registration and login from Discourse to another site. Offered to our pro, business and en… --- ## [Troubleshooting Outgoing Email](https://meta.discourse.org/t/troubleshooting-outgoing-email/271484)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 4\ **Last updated:** [February 27, 2024, 9:20pm UTC](https://meta.discourse.org/t/troubleshooting-outgoing-email/271484 "2024-02-27T21:20:04Z")
:bookmark: This is an explanation guide discussing how admins can troubleshoot outgoing email from a Discourse site. :person\_raising\_hand: Required user level: Administrator Discourse relies heavily on email for user… --- ## [Watched Words Reference Guide](https://meta.discourse.org/t/watched-words-reference-guide/241735)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 16\ **Last updated:** [February 16, 2026, 2:30pm UTC](https://meta.discourse.org/t/watched-words-reference-guide/241735 "2026-02-16T14:30:34Z")
:bookmark: This is a reference guide for describing how the Watched Words page functions and the different types of action types you can use to block specific words on a Discourse site. :person\_raising\_hand: Required u… --- ## [Integrate Google Tag Manager with Google Analytics](https://meta.discourse.org/t/integrate-google-tag-manager-with-google-analytics/47335)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 4\ **Last updated:** [January 26, 2025, 5:47pm UTC](https://meta.discourse.org/t/integrate-google-tag-manager-with-google-analytics/47335 "2025-01-26T17:47:40Z")
:bookmark: This guide will help you set up Google Tag Manager and use it with Google Analytics on your Discourse site. Additionally, it covers configuring variables, triggers, and tags in Google Tag Manager to track pag… --- ## [Understanding pageviews and the site traffic report](https://meta.discourse.org/t/understanding-pageviews-and-the-site-traffic-report/324062)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [May 5, 2026, 11:27pm UTC](https://meta.discourse.org/t/understanding-pageviews-and-the-site-traffic-report/324062 "2026-05-05T23:27:54Z")
:bookmark: This is an explanation about how Discourse handles pageviews and how to interpret the “Site traffic” report. :person\_raising\_hand: Required user level: Administrator What are pageviews in Discourse? Pagev… --- ## [Developing Discourse Plugins - Part 2 - Connect to a plugin outlet](https://meta.discourse.org/t/developing-discourse-plugins-part-2-connect-to-a-plugin-outlet/31001)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 38\ **Last updated:** [November 23, 2025, 9:35am UTC](https://meta.discourse.org/t/developing-discourse-plugins-part-2-connect-to-a-plugin-outlet/31001 "2025-11-23T09:35:13Z")
Previous tutorial: Developing Discourse Plugins - Part 1 - Create a basic plugin Getting Started: Templates Discourse’s client application is written using the Ember.js Javascript framework. Ember uses Templates to gen… --- ## [Add custom content that only appears on your homepage](https://meta.discourse.org/t/add-custom-content-that-only-appears-on-your-homepage/131415)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 10\ **Last updated:** [February 29, 2024, 3:04pm UTC](https://meta.discourse.org/t/add-custom-content-that-only-appears-on-your-homepage/131415 "2024-02-29T15:04:44Z")
A very common situation you’ll find yourself in as a theme developer is the need to create content that only shows on the homepage of your community. You might add some HTML to the “After Header” section of your theme, … --- ## [Customizing specific system email templates](https://meta.discourse.org/t/customizing-specific-system-email-templates/88323)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 8\ **Last updated:** [November 3, 2025, 8:19am UTC](https://meta.discourse.org/t/customizing-specific-system-email-templates/88323 "2025-11-03T08:19:11Z")
Customizing specific system email templates :bookmark: This guide explains how to customize the individual email templates that Discourse uses for account notifications, invitations, admin alerts, and other system emai… --- ## [Moving posts to a new or existing topic](https://meta.discourse.org/t/moving-posts-to-a-new-or-existing-topic/136733)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [December 20, 2019, 7:40pm UTC](https://meta.discourse.org/t/moving-posts-to-a-new-or-existing-topic/136733 "2019-12-20T19:40:25Z")
:bookmark: This guide explains how to move posts to a new or existing topic, or to a new or existing personal message in Discourse. This feature helps keep discussions on topic and allows for moving public discussions t… --- ## [Enable setting to allow admins to permanently delete data](https://meta.discourse.org/t/enable-setting-to-allow-admins-to-permanently-delete-data/206678)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 3\ **Last updated:** [April 30, 2026, 9:38am UTC](https://meta.discourse.org/t/enable-setting-to-allow-admins-to-permanently-delete-data/206678 "2026-04-30T09:38:49Z")
:bookmark: This is a guide on how to enable the setting for administrators to permanently delete data on a Discourse instance. :person\_raising\_hand: Required user level: Admin As of v2026.4.0 Changelog | Discourse Re… --- ## [Using Hidden Site Settings](https://meta.discourse.org/t/using-hidden-site-settings/308773)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 20, 2024, 10:51pm UTC](https://meta.discourse.org/t/using-hidden-site-settings/308773 "2024-05-20T22:51:56Z")
:bookmark: This is a how-to guide about Hidden Site Settings, how to enable them, and why you might want to adjust them. :person\_raising\_hand: Required user level: Administrator :warning: Important: Console access is … --- ## [Hidden Site Settings Reference Guide](https://meta.discourse.org/t/hidden-site-settings-reference-guide/308774)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 20, 2024, 10:55pm UTC](https://meta.discourse.org/t/hidden-site-settings-reference-guide/308774 "2024-05-20T22:55:23Z")
:bookmark: This is a reference guide for describing all available Hidden Site Settings. :person\_raising\_hand: Required user level: Administrator Hidden site settings in Discourse are advanced configuration options th… --- ## [Using Regex with Watched Words](https://meta.discourse.org/t/using-regex-with-watched-words/241861)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 1\ **Last updated:** [June 14, 2024, 6:03pm UTC](https://meta.discourse.org/t/using-regex-with-watched-words/241861 "2024-06-14T18:03:17Z")
:bookmark: This topic explains how to effectively use regular expressions (regex) within Discourse’s Watched Words feature. :discourse: For sites on our hosting, these settings are hidden. Customers on paid hosting pla… --- ## [Troubleshoot email on a new Discourse install](https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install/16326)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 36\ **Last updated:** [April 27, 2026, 7:59pm UTC](https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install/16326 "2026-04-27T19:59:20Z")
You just installed Discourse via the install guide, but email doesn’t seem to work. Unfortunately this means you can’t log in as an admin to finalize the install. :cry: Let’s troubleshootize! Try the doctor … --- ## [Using Discourse with Cloudflare: Best Practices](https://meta.discourse.org/t/using-discourse-with-cloudflare-best-practices/293405)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 28\ **Last updated:** [April 26, 2026, 7:31pm UTC](https://meta.discourse.org/t/using-discourse-with-cloudflare-best-practices/293405 "2026-04-26T19:31:10Z")
Using Discourse with Cloudflare :bookmark: This guide explains how to configure and use Discourse with Cloudflare, including security best practices and troubleshooting tips. :person\_raising\_hand: Required user level:… --- ## [Trust Level Permissions Reference](https://meta.discourse.org/t/trust-level-permissions-reference/224824)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 31\ **Last updated:** [August 27, 2025, 7:17pm UTC](https://meta.discourse.org/t/trust-level-permissions-reference/224824 "2025-08-27T19:17:11Z")
:bookmark: This reference aims to be a comprehensive list of Discourse features, marked by Trust Level, and including the relevant admin settings which influence them. Trust level names TL0: New (newuser) TL1: Basic … --- ## [AI bot - Agents](https://meta.discourse.org/t/ai-bot-agents/306099)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 26\ **Last updated:** [April 15, 2026, 6:17am UTC](https://meta.discourse.org/t/ai-bot-agents/306099 "2026-04-15T06:17:01Z")
:bookmark: This guide explains how to set up and manage Agents for Discourse AI - AI bot. :person\_raising\_hand: Required user level: Administrator The Discourse AI bot includes a flexible system for managing Agents. … --- ## [Customize Your Site Branding](https://meta.discourse.org/t/customize-your-site-branding/258307)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 6\ **Last updated:** [September 30, 2025, 11:39pm UTC](https://meta.discourse.org/t/customize-your-site-branding/258307 "2025-09-30T23:39:59Z")
:bookmark: This is a non-technical tutorial that will guide you through customizing the branding and appearance for your Discourse site. :person\_raising\_hand: Required user level: Administrator Want to customize your… --- ## [Creating and configuring custom user fields](https://meta.discourse.org/t/creating-and-configuring-custom-user-fields/113192)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 25\ **Last updated:** [April 8, 2026, 11:33am UTC](https://meta.discourse.org/t/creating-and-configuring-custom-user-fields/113192 "2026-04-08T11:33:46Z")
:bookmark: This guide explains how to create and configure custom user fields in Discourse, including how to add them to the signup form, user profiles, and user directory. :person\_raising\_hand: Required user level: Ad… --- ## [Alternative icons](https://meta.discourse.org/t/alternative-icons/206693)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 28\ **Last updated:** [April 7, 2026, 4:36pm UTC](https://meta.discourse.org/t/alternative-icons/206693 "2026-04-07T16:36:02Z")
By default, Discourse bundles icons from the excellent FontAwesome library. But there are a lot of free-to-use icon libraries out there. This topic is the home of alternative icon sets. It lists some theme components tha… --- ## [Integrations Index](https://meta.discourse.org/t/integrations-index/308033)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [May 15, 2024, 6:03am UTC](https://meta.discourse.org/t/integrations-index/308033 "2024-05-15T06:03:51Z")
Documentation about connecting Discourse with other platforms and services. General Create API keys: Create and configure an API key Scoped API keys: Use scoped API Keys Embed topics list: Embed a list of Discourse top… --- ## [Filtering topic lists in Discourse](https://meta.discourse.org/t/filtering-topic-lists-in-discourse/375558)
**Author:** [@sam](https://meta.discourse.org/u/sam)\ **Replies:** 19\ **Last updated:** [April 3, 2026, 9:08am UTC](https://meta.discourse.org/t/filtering-topic-lists-in-discourse/375558 "2026-04-03T09:08:14Z")
:bookmark: This guide explains Discourse’s advanced topic filtering system, including the complete query language syntax, filter options, and how to use the /filter route effectively. :person\_raising\_hand: Required use… --- ## [Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver](https://meta.discourse.org/t/configure-direct-delivery-incoming-email-for-self-hosted-sites-with-mail-receiver/49487)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 76\ **Last updated:** [March 27, 2026, 1:20am UTC](https://meta.discourse.org/t/configure-direct-delivery-incoming-email-for-self-hosted-sites-with-mail-receiver/49487 "2026-03-27T01:20:21Z")
Discourse is all about enabling civilized discussion. While plenty of people like a web interface, e-mail is still the “hub” of many people’s online lives. That’s why sending e-mail is so important, and when you’re sen… --- ## [Creating a banner to display at the top of your site](https://meta.discourse.org/t/creating-a-banner-to-display-at-the-top-of-your-site/153718)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 11\ **Last updated:** [January 7, 2026, 1:50pm UTC](https://meta.discourse.org/t/creating-a-banner-to-display-at-the-top-of-your-site/153718 "2026-01-07T13:50:35Z")
:bookmark: This guide explains different methods to create and customize banners on your Discourse site, from simple dismissible banners to more advanced options. :person\_raising\_hand: Required user level: Moderator (D… --- ## [Helper - captioning images](https://meta.discourse.org/t/helper-captioning-images/336100)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 9\ **Last updated:** [September 2, 2025, 11:07am UTC](https://meta.discourse.org/t/helper-captioning-images/336100 "2025-09-02T11:07:39Z")
:bookmark: This guide explains how to enable and configure AI powered image captions, which is part of the Helper feature of Discourse AI plugin. :person\_raising\_hand: Required user level: Administrator Image caption… --- ## [Enable group sync from Google Workplace](https://meta.discourse.org/t/enable-group-sync-from-google-workplace/226850)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 7\ **Last updated:** [April 11, 2025, 2:03am UTC](https://meta.discourse.org/t/enable-group-sync-from-google-workplace/226850 "2025-04-11T02:03:14Z")
To get started, configure Google login according to these instructions: Then, follow these steps: In the google dashboard for your OAuth integration, go to “APIs and Services”, and add "Admin SDK → → Go to … --- ## [Recover a user who was deleted as a spammer](https://meta.discourse.org/t/recover-a-user-who-was-deleted-as-a-spammer/33372)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [September 16, 2015, 8:44pm UTC](https://meta.discourse.org/t/recover-a-user-who-was-deleted-as-a-spammer/33372 "2015-09-16T20:44:27Z")
:bookmark: This guide explains how to recover users and their content after they were mistakenly deleted as spammers. :person\_raising\_hand: Required user level: Administrator When a user is mistakenly flagged as a sp… --- ## [Configure a firewall for Discourse](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 5\ **Last updated:** [March 25, 2025, 11:14pm UTC](https://meta.discourse.org/t/configure-a-firewall-for-discourse/20584 "2025-03-25T23:14:23Z")
If you are using a standard Docker based Discourse install, the following Uncomplicated Firewall rules will protect any non-Docker services on your server: ufw allow http ufw allow https ufw allow ssh ufw enable That i… --- ## [Change the domain name or rename your Discourse](https://meta.discourse.org/t/change-the-domain-name-or-rename-your-discourse/16098)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 7\ **Last updated:** [June 19, 2025, 6:23pm UTC](https://meta.discourse.org/t/change-the-domain-name-or-rename-your-discourse/16098 "2025-06-19T18:23:25Z")
:bookmark: This guide explains how-to change the domain name of your Discourse site, and includes information about setting up DNS changes, editing configuration files, updating site settings, and correcting social logi… --- ## [Configuring Activity Summary emails](https://meta.discourse.org/t/configuring-activity-summary-emails/36627)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 6\ **Last updated:** [June 30, 2025, 2:28pm UTC](https://meta.discourse.org/t/configuring-activity-summary-emails/36627 "2025-06-30T14:28:58Z")
:bookmark: This guide explains how to configure and manage activity summary emails in Discourse, including user and admin options, customization, and troubleshooting. :person\_raising\_hand: Required user level: Administ… [Previous page](https://meta.discourse.org/c/documentation/10.md?page=1&search=search) [Next page](https://meta.discourse.org/c/documentation/10.md?page=3&search=search)