# Documentation

**URL:** https://meta.discourse.org/c/documentation/10.md?page=5

[Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md)

**Page:** 6

---

## [Using Hidden Site Settings](https://meta.discourse.org/t/using-hidden-site-settings/308773)

<div class="topic-metadata">

**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")

</div>

: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)

<div class="topic-metadata">

**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")

</div>

: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…

---

## [Hidden Settings on Discourse Hosted Sites](https://meta.discourse.org/t/hidden-settings-on-discourse-hosted-sites/310574)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 3\
**Last updated:** [March 12, 2026, 11:15pm UTC](https://meta.discourse.org/t/hidden-settings-on-discourse-hosted-sites/310574 "2026-03-12T23:15:59Z")

</div>

:bookmark: This is a guide for describing all available hidden site settings on Discourse hosted sites, how to request them, and why you might want to adjust them. :person\_raising\_hand: Required user level: Administrat…

---

## [Using Regex with Watched Words](https://meta.discourse.org/t/using-regex-with-watched-words/241861)

<div class="topic-metadata">

**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")

</div>

: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…

---

## [Add group owners to manage group membership](https://meta.discourse.org/t/add-group-owners-to-manage-group-membership/36233)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 2\
**Last updated:** [April 29, 2026, 8:39am UTC](https://meta.discourse.org/t/add-group-owners-to-manage-group-membership/36233 "2026-04-29T08:39:29Z")

</div>

:bookmark: This guide explains how to add group owners who will manage group membership in your Discourse community. :person\_raising\_hand: Required user level: Administrator Admins can add users as group owners, allo…

---

## [Troubleshoot email on a new Discourse install](https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install/16326)

<div class="topic-metadata">

**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")

</div>

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)

<div class="topic-metadata">

**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")

</div>

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)

<div class="topic-metadata">

**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")

</div>

: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 …

---

## [Enable and configure anonymous mode](https://meta.discourse.org/t/enable-and-configure-anonymous-mode/155638)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [June 23, 2020, 12:01am UTC](https://meta.discourse.org/t/enable-and-configure-anonymous-mode/155638 "2020-06-23T00:01:13Z")

</div>

:bookmark: This guide details how-to enable and configure anonymous mode in Discourse for users who want to post without revealing their identity. :person\_raising\_hand: Required user level: Administrator Anonymous mo…

---

## [Use Caddy instead of NGINX as your reverse proxy](https://meta.discourse.org/t/use-caddy-instead-of-nginx-as-your-reverse-proxy/54716)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 20\
**Last updated:** [February 26, 2026, 8:19pm UTC](https://meta.discourse.org/t/use-caddy-instead-of-nginx-as-your-reverse-proxy/54716 "2026-02-26T20:19:28Z")

</div>

Here are some notes about how I got my test Discourse instance running with Caddy Server. Cool stuff about Caddy: They use Discourse :smile: Free SSL with Let’s Encrypt HTTP2 and QUIC out of the box Easier…

---

## [AI bot - Agents](https://meta.discourse.org/t/ai-bot-agents/306099)

<div class="topic-metadata">

**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")

</div>

: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)

<div class="topic-metadata">

**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")

</div>

: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)

<div class="topic-metadata">

**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")

</div>

: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)

<div class="topic-metadata">

**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")

</div>

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…

---

## [Configuring and managing the sign-up flow with user approval](https://meta.discourse.org/t/configuring-and-managing-the-sign-up-flow-with-user-approval/112128)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 8\
**Last updated:** [April 4, 2026, 11:02pm UTC](https://meta.discourse.org/t/configuring-and-managing-the-sign-up-flow-with-user-approval/112128 "2026-04-04T23:02:29Z")

</div>

:bookmark: This guide explains the sign-up process when the “must approve users” setting is enabled, including configuration steps and the user experience. :person\_raising\_hand: Required user level: Administrator Whe…

---

## [Integrations Index](https://meta.discourse.org/t/integrations-index/308033)

<div class="topic-metadata">

**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")

</div>

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)

<div class="topic-metadata">

**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")

</div>

: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…

---

## [Migrate a mailing list to Discourse (mbox, Listserv, Google Groups, etc)](https://meta.discourse.org/t/migrate-a-mailing-list-to-discourse-mbox-listserv-google-groups-etc/79773)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 109\
**Last updated:** [April 3, 2026, 2:28am UTC](https://meta.discourse.org/t/migrate-a-mailing-list-to-discourse-mbox-listserv-google-groups-etc/79773 "2026-04-03T02:28:34Z")

</div>

This guide is for you if you want to migrate a mailing list to Discourse. It also contains instructions for importing messages from Google Groups. 1. Importing using Docker container This is the recommended way for…

---

## [Configuring Amazon Bedrock services](https://meta.discourse.org/t/configuring-amazon-bedrock-services/340742)

<div class="topic-metadata">

**Author:** [@sam](https://meta.discourse.org/u/sam)\
**Replies:** 0\
**Last updated:** [December 5, 2024, 10:23pm UTC](https://meta.discourse.org/t/configuring-amazon-bedrock-services/340742 "2024-12-05T22:23:55Z")

</div>

:bookmark: This guide explains how to configure API keys for Amazon Bedrock to enable Discourse AI features that require 3rd party LLM keys. :person\_raising\_hand: Required user level: Administrator In this example, w…

---

## [Trigger a Zapier task with Discourse Webhooks](https://meta.discourse.org/t/trigger-a-zapier-task-with-discourse-webhooks/56753)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [February 1, 2017, 10:11pm UTC](https://meta.discourse.org/t/trigger-a-zapier-task-with-discourse-webhooks/56753 "2017-02-01T22:11:22Z")

</div>

Want to use Discourse Webhooks to trigger a task via Zapier? Let’s get started! :bulb: Tip: Zapier now has an official Discourse integration with built-in triggers and actions (e.g. “New Post”, “Create Post”). For…

---

## [AI Bot – Bring Your Own MCP Server](https://meta.discourse.org/t/ai-bot-bring-your-own-mcp-server/399667)

<div class="topic-metadata">

**Author:** [@sam](https://meta.discourse.org/u/sam)\
**Replies:** 0\
**Last updated:** [March 31, 2026, 11:40pm UTC](https://meta.discourse.org/t/ai-bot-bring-your-own-mcp-server/399667 "2026-03-31T23:40:29Z")

</div>

:bookmark: This guide explains how to connect external Model Context Protocol (MCP) servers to Discourse AI agents, allowing any MCP-compatible tool provider to be used directly inside the AI bot. :person\_raising\_hand: …

---

## [Understanding Discourse release channels](https://meta.discourse.org/t/understanding-discourse-release-channels/264400)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [May 9, 2023, 1:39pm UTC](https://meta.discourse.org/t/understanding-discourse-release-channels/264400 "2023-05-09T13:39:21Z")

</div>

:bookmark: This guide explains the different types of Discourse releases and how different channels are used for updates. :person\_raising\_hand: Required user level: All users Release channels Discourse has four prim…

---

## [Handling split-horizon / split-view DNS while on our hosting](https://meta.discourse.org/t/handling-split-horizon-split-view-dns-while-on-our-hosting/121902)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [July 2, 2019, 3:57pm UTC](https://meta.discourse.org/t/handling-split-horizon-split-view-dns-while-on-our-hosting/121902 "2019-07-02T15:57:01Z")

</div>

Sometimes even after correctly configuring DNS for your new Discourse site hosted with us: You still cannot access the site and only reach an error page: If this persists for a while (nameservers will cache negat…

---

## [Do you offer yearly billing options?](https://meta.discourse.org/t/do-you-offer-yearly-billing-options/306415)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [May 1, 2024, 11:39pm UTC](https://meta.discourse.org/t/do-you-offer-yearly-billing-options/306415 "2024-05-01T23:39:24Z")

</div>

:bookmark: This guide explains how to change your billing cycle from monthly to yearly/annual payments for your Discourse hosted plan. :person\_raising\_hand: Required user level: Admin Summary Discourse hosted plans …

---

## [Create a Data Explorer query using the API](https://meta.discourse.org/t/create-a-data-explorer-query-using-the-api/394388)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 3\
**Last updated:** [March 29, 2026, 7:46pm UTC](https://meta.discourse.org/t/create-a-data-explorer-query-using-the-api/394388 "2026-03-29T19:46:03Z")

</div>

Create a Data Explorer query with the API :bookmark: This how-to guide explains how to create a Data Explorer query using the Discourse API. :person\_raising\_hand: Required user level: Administrator Prerequisites B…

---

## [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)

<div class="topic-metadata">

**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")

</div>

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)

<div class="topic-metadata">

**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")

</div>

: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…

---

## [Theme modifiers: A brief introduction](https://meta.discourse.org/t/theme-modifiers-a-brief-introduction/150605)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 19\
**Last updated:** [October 24, 2025, 6:20am UTC](https://meta.discourse.org/t/theme-modifiers-a-brief-introduction/150605 "2025-10-24T06:20:57Z")

</div>

As themes become more ambitious, we’ve been looking for ways to allow them to manipulate core server-side behavior. While they will never be given the same level as control as plugins, we can provide some predefined hook…

---

## [Use Discourse Core Variables in your Theme](https://meta.discourse.org/t/use-discourse-core-variables-in-your-theme/77551)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [January 9, 2018, 4:55am UTC](https://meta.discourse.org/t/use-discourse-core-variables-in-your-theme/77551 "2018-01-09T04:55:37Z")

</div>

Discourse is incredibly customizable! The goal of this topic is to show you how make use of all the amazing options that are available to you as a theme developer. You know… so that you don’t have to reinvent the wheel …

---

## [Add a new provider to discourse-chat-integration](https://meta.discourse.org/t/add-a-new-provider-to-discourse-chat-integration/68156)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [August 16, 2017, 1:28pm UTC](https://meta.discourse.org/t/add-a-new-provider-to-discourse-chat-integration/68156 "2017-08-16T13:28:28Z")

</div>

discourse-chat-integration abstracts away the boilerplate for integrating Discourse with external chatroom systems. There are three features which a provider implementation can support: Notifications, Slash Commands and T…

[Previous page](https://meta.discourse.org/c/documentation/10.md?page=4)

[Next page](https://meta.discourse.org/c/documentation/10.md?page=6)
