# Documentation

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

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

**Page:** 4

---

## [Self-Hosting an OpenSource LLM for DiscourseAI](https://meta.discourse.org/t/self-hosting-an-opensource-llm-for-discourseai/290923)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 12\
**Last updated:** [July 6, 2026, 6:36pm UTC](https://meta.discourse.org/t/self-hosting-an-opensource-llm-for-discourseai/290923 "2026-07-06T18:36:54Z")

</div>

The Discourse AI plugin has many features that require an LLM to be enabled, like, for example, Summarization, AI Helper, AI Search, AI Bot. While you can use a third party API, like Configure API Keys for OpenAI or Conf…

---

## [Handling the "chain of trust" of the end user's real IP](https://meta.discourse.org/t/handling-the-chain-of-trust-of-the-end-users-real-ip/406372)

<div class="topic-metadata">

**Author:** [@supermathie](https://meta.discourse.org/u/supermathie)\
**Replies:** 7\
**Last updated:** [July 2, 2026, 2:03pm UTC](https://meta.discourse.org/t/handling-the-chain-of-trust-of-the-end-users-real-ip/406372 "2026-07-02T14:03:37Z")

</div>

Background Discourse needs to be aware of the end user’s real IP address. However, an end user never directly connects to Discourse since there is always one or more upstream web servers (nginx running in the Discourse …

---

## [Run other websites on the same machine as Discourse](https://meta.discourse.org/t/run-other-websites-on-the-same-machine-as-discourse/17247)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 66\
**Last updated:** [June 30, 2026, 11:19am UTC](https://meta.discourse.org/t/run-other-websites-on-the-same-machine-as-discourse/17247 "2026-06-30T11:19:56Z")

</div>

If you want to run other websites on the same machine as Discourse, you need to set up an extra NGINX or HAProxy proxy in front of the Docker container. NOTE: This is for advanced admins This guide assumes you already …

---

## [Understanding closed, unlisted, and archived topics](https://meta.discourse.org/t/understanding-closed-unlisted-and-archived-topics/51238)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 3\
**Last updated:** [July 13, 2025, 10:34pm UTC](https://meta.discourse.org/t/understanding-closed-unlisted-and-archived-topics/51238 "2025-07-13T22:34:57Z")

</div>

:bookmark: This guide explains the differences between closed, unlisted, and archived topics in Discourse, including their characteristics, visual indicators, and use cases. :person\_raising\_hand: Required user level: A…

---

## [Serve Discourse from a subfolder (path prefix) instead of a subdomain](https://meta.discourse.org/t/serve-discourse-from-a-subfolder-path-prefix-instead-of-a-subdomain/30507)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 30\
**Last updated:** [April 14, 2026, 9:15pm UTC](https://meta.discourse.org/t/serve-discourse-from-a-subfolder-path-prefix-instead-of-a-subdomain/30507 "2026-04-14T21:15:09Z")

</div>

:warning: Discourse Official Statement about Subfolder setup We support subfolder setups for our hosted customers at the enterprise level and up. Due to heavy technical setup complexity we strongly recommend you do not…

---

## [Theme Developer Tutorial: 1. Introduction](https://meta.discourse.org/t/theme-developer-tutorial-1-introduction/357796)

<div class="topic-metadata">

**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-1-introduction/357796 "2025-03-18T15:59:08Z")

</div>

This tutorial will teach you how to create a Discourse Theme or Theme Component from the ground up. While this topic assumes no previous experience working on Discourse themes, it does assume some prior experience using H…

---

## [Change icons globally](https://meta.discourse.org/t/change-icons-globally/87751)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 26\
**Last updated:** [October 5, 2025, 1:10pm UTC](https://meta.discourse.org/t/change-icons-globally/87751 "2025-10-05T13:10:20Z")

</div>

This is an easy way to change a Discourse icon globally. Right click on the icon you want to change and select “Inspect element” or “Inspect” (depends on the browser) Find the icon name Search a new icon here…

---

## [Minimizing Maintenance on Theme Customizations](https://meta.discourse.org/t/minimizing-maintenance-on-theme-customizations/261388)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [April 11, 2023, 11:58pm UTC](https://meta.discourse.org/t/minimizing-maintenance-on-theme-customizations/261388 "2023-04-11T23:58:36Z")

</div>

Discourse is highly customizable, enabling you to modify almost any aspect of its appearance through themes. To maintain compatibility with ongoing Discourse updates and new features, all themes require occasional maint…

---

## [Developing Discourse Plugins - Part 7 - Publish your plugin](https://meta.discourse.org/t/developing-discourse-plugins-part-7-publish-your-plugin/101636)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 4\
**Last updated:** [July 29, 2021, 2:01pm UTC](https://meta.discourse.org/t/developing-discourse-plugins-part-7-publish-your-plugin/101636 "2021-07-29T14:01:04Z")

</div>

Previous tutorial: Developing Discourse Plugins - Part 6 - Add acceptance tests You’ve created your plugin, you’ve uploaded it to GitHub and you’ve added tests. Great! Problem is, no one else knows about it. Documenti…

---

## [Discourse Moderation Guide - Part 3: Managing Content](https://meta.discourse.org/t/discourse-moderation-guide-part-3-managing-content/406266)

<div class="topic-metadata">

**Author:** [@MarkDoerr](https://meta.discourse.org/u/MarkDoerr)\
**Replies:** 0\
**Last updated:** [June 27, 2026, 1:08am UTC](https://meta.discourse.org/t/discourse-moderation-guide-part-3-managing-content/406266 "2026-06-27T01:08:09Z")

</div>

:bookmark: This guide details how to manage topics, handle flags, use the Review Queue, and configure content approval settings in Discourse. It covers de-escalation techniques, flag handling workflows, and moderation t…

---

## [Configuring incoming email to create new topics or group messages](https://meta.discourse.org/t/configuring-incoming-email-to-create-new-topics-or-group-messages/62977)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 3\
**Last updated:** [February 10, 2026, 9:21am UTC](https://meta.discourse.org/t/configuring-incoming-email-to-create-new-topics-or-group-messages/62977 "2026-02-10T09:21:38Z")

</div>

:bookmark: This guide explains how to configure Discourse to create new topics or group messages from incoming emails. It covers site settings, group configuration, and category settings. :person\_raising\_hand: Required…

---

## [Site Management Index](https://meta.discourse.org/t/site-management-index/308032)

<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/site-management-index/308032 "2024-05-15T06:03:18Z")

</div>

Documentation covering the configuration, setup, and ongoing management of Discourse - useful for site owners and administrators. Users User statuses: Understanding user statuses, roles, and permissions Configure invit…

---

## [Discourse Moderation Guide - Part 1: Getting Started](https://meta.discourse.org/t/discourse-moderation-guide-part-1-getting-started/63116)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 5\
**Last updated:** [June 25, 2026, 10:18pm UTC](https://meta.discourse.org/t/discourse-moderation-guide-part-1-getting-started/63116 "2026-06-25T22:18:21Z")

</div>

:bookmark: This guide introduces the role of a moderator in a Discourse forum, explaining how to welcome new users, recognize helpful contributors, and communicate effectively with your moderation team. It covers the fo…

---

## [Discourse Moderation Guide - Part 2: Managing Users](https://meta.discourse.org/t/discourse-moderation-guide-part-2-managing-users/406265)

<div class="topic-metadata">

**Author:** [@MarkDoerr](https://meta.discourse.org/u/MarkDoerr)\
**Replies:** 0\
**Last updated:** [June 27, 2026, 1:07am UTC](https://meta.discourse.org/t/discourse-moderation-guide-part-2-managing-users/406265 "2026-06-27T01:07:49Z")

</div>

:bookmark: This guide explains how to access user information, understand trust levels, and handle difficult users through warnings, silencing, suspensions, and trust level restrictions in Discourse. …

---

## [Configuring and troubleshooting oneboxes](https://meta.discourse.org/t/configuring-and-troubleshooting-oneboxes/239715)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 2\
**Last updated:** [June 26, 2026, 9:49pm UTC](https://meta.discourse.org/t/configuring-and-troubleshooting-oneboxes/239715 "2026-06-26T21:49:14Z")

</div>

:bookmark: This guide explains how to configure and troubleshoot oneboxes in Discourse. It covers admin settings, how oneboxes work, and steps to resolve common issues. :person\_raising\_hand: Required user level: Admini…

---

## [Discourse Trust Levels: A Detailed Explanation](https://meta.discourse.org/t/discourse-trust-levels-a-detailed-explanation/396792)

<div class="topic-metadata">

**Author:** [@chapoi](https://meta.discourse.org/u/chapoi)\
**Replies:** 11\
**Last updated:** [June 26, 2026, 3:54pm UTC](https://meta.discourse.org/t/discourse-trust-levels-a-detailed-explanation/396792 "2026-06-26T15:54:58Z")

</div>

This topic explains how the Discourse trust level system works behind the scenes. It provides an overview of how each level is calculated and describes in more detail what requirements need to be met to progress. While m…

---

## [Understanding and customizing the About page](https://meta.discourse.org/t/understanding-and-customizing-the-about-page/332161)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [October 29, 2024, 1:31pm UTC](https://meta.discourse.org/t/understanding-and-customizing-the-about-page/332161 "2024-10-29T13:31:19Z")

</div>

:bookmark: This documentation provides an overview of the About page on a Discourse site and explains how admins can customize it. :person\_raising\_hand: Required user level: Administrator :computer: Console access not…

---

## [Scheduling topics for future publication](https://meta.discourse.org/t/scheduling-topics-for-future-publication/60731)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [April 10, 2017, 6:15pm UTC](https://meta.discourse.org/t/scheduling-topics-for-future-publication/60731 "2017-04-10T18:15:20Z")

</div>

:bookmark: This guide explains how to use topic timers to schedule a topic for future publication in Discourse. Discourse allows you to create topics and schedule them for publication at a later date using topic timer…

---

## [Invite users to a group](https://meta.discourse.org/t/invite-users-to-a-group/15544)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 2\
**Last updated:** [July 26, 2024, 3:49am UTC](https://meta.discourse.org/t/invite-users-to-a-group/15544 "2024-07-26T03:49:43Z")

</div>

:bookmark: This guide explains how to invite users to a group in your Discourse community, covering methods for administrators, group owners, and moderators with specific permissions. :person\_raising\_hand: Required use…

---

## [Redirect old forum URLs to new Discourse URLs using permalinks](https://meta.discourse.org/t/redirect-old-forum-urls-to-new-discourse-urls-using-permalinks/20930)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 10\
**Last updated:** [September 13, 2024, 1:29pm UTC](https://meta.discourse.org/t/redirect-old-forum-urls-to-new-discourse-urls-using-permalinks/20930 "2024-09-13T13:29:44Z")

</div>

:bookmark: This reference explains how Discourse permalinks redirect old URL paths to new destinations, how permalink normalizations work, and how to test and troubleshoot redirects after a migration or URL structure …

---

## [Finding Discourse RSS feeds](https://meta.discourse.org/t/finding-discourse-rss-feeds/264134)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 25\
**Last updated:** [January 18, 2025, 1:18pm UTC](https://meta.discourse.org/t/finding-discourse-rss-feeds/264134 "2025-01-18T13:18:10Z")

</div>

:bookmark: A comprehensive reference guide to all available RSS feeds in Discourse, including URL structures, authentication requirements, and best practices for feed readers. :person\_raising\_hand: Required user level:…

---

## [Making your forum more accessible](https://meta.discourse.org/t/making-your-forum-more-accessible/226242)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 4\
**Last updated:** [June 15, 2026, 2:02pm UTC](https://meta.discourse.org/t/making-your-forum-more-accessible/226242 "2026-06-15T14:02:27Z")

</div>

:bookmark: This guide explains how to make your Discourse forum more accessible by utilizing WCAG compliant color schemes. It covers instructions for site administrators, theme creators, and end users. …

---

## [Administrative Bulk Operations](https://meta.discourse.org/t/administrative-bulk-operations/118349)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 9\
**Last updated:** [June 12, 2026, 7:43pm UTC](https://meta.discourse.org/t/administrative-bulk-operations/118349 "2026-06-12T19:43:12Z")

</div>

Below you will find a collection of bulk operations that can be initiated from the command line. You will need SSH access, so if you are a hosted customer, you will need to contact the Discourse team about running thes…

---

## [Generate new topics, posts and PM via IFTTT](https://meta.discourse.org/t/generate-new-topics-posts-and-pm-via-ifttt/61336)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 5\
**Last updated:** [March 23, 2023, 10:43pm UTC](https://meta.discourse.org/t/generate-new-topics-posts-and-pm-via-ifttt/61336 "2023-03-23T22:43:21Z")

</div>

Want to use IFTTT to create new topics, posts and personal messages? Let’s get started! Using Maker Webhooks of IFTTT service we can make Discourse API calls. For that we must generate API keys first. You can create API…

---

## [Discourse AI - Web Artifacts](https://meta.discourse.org/t/discourse-ai-web-artifacts/339972)

<div class="topic-metadata">

**Author:** [@sam](https://meta.discourse.org/u/sam)\
**Replies:** 4\
**Last updated:** [June 13, 2025, 6:58pm UTC](https://meta.discourse.org/t/discourse-ai-web-artifacts/339972 "2025-06-13T18:58:11Z")

</div>

What Are AI Artifacts? AI Artifacts are powerful tools that allow users to create, embed, and interact with dynamic web-based components directly within a Discourse post. These components can contain custom HTML, CSS, an…

---

## [Configuring auto-bumping for topics](https://meta.discourse.org/t/configuring-auto-bumping-for-topics/262158)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 24\
**Last updated:** [June 6, 2026, 8:10pm UTC](https://meta.discourse.org/t/configuring-auto-bumping-for-topics/262158 "2026-06-06T20:10:57Z")

</div>

:bookmark: This guide explains how to set up and use auto-bumping for topics in Discourse, including category-wide settings and individual topic timers. :person\_raising\_hand: Required user level: Administrator Auto-b…

---

## [How do I cancel my hosting plan?](https://meta.discourse.org/t/how-do-i-cancel-my-hosting-plan/306413)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [May 1, 2024, 11:36pm UTC](https://meta.discourse.org/t/how-do-i-cancel-my-hosting-plan/306413 "2024-05-01T23:36:57Z")

</div>

:bookmark: This guide explains how to cancel your Discourse hosted service, download your data, and understand your options for maintaining limited access to your site. :person\_raising\_hand: Required user level: Admini…

---

## [Configure Facebook login for Discourse](https://meta.discourse.org/t/configure-facebook-login-for-discourse/13394)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 37\
**Last updated:** [June 3, 2026, 12:45pm UTC](https://meta.discourse.org/t/configure-facebook-login-for-discourse/13394 "2026-06-03T12:45:59Z")

</div>

:exclamation: As of February 2023, Meta has implemented a business verification requirement when publishing new and existing apps. :warning: Updating the Facebook app API or creating a new app will break existing login…

---

## [Embed Discourse comments on another website via Javascript](https://meta.discourse.org/t/embed-discourse-comments-on-another-website-via-javascript/31963)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 127\
**Last updated:** [June 2, 2026, 7:14pm UTC](https://meta.discourse.org/t/embed-discourse-comments-on-another-website-via-javascript/31963 "2026-06-02T19:14:05Z")

</div>

Discourse has the ability to embed the comments from a topic in a remote site using a Javascript API that creates an IFRAME. For an example of this in action, check out Coding Horror’s blog. The blog is run via Ghost b…

---

## [Insert text or images anywhere on your site using CSS pseudo-elements](https://meta.discourse.org/t/insert-text-or-images-anywhere-on-your-site-using-css-pseudo-elements/99200)

<div class="topic-metadata">

**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\
**Replies:** 0\
**Last updated:** [October 11, 2018, 11:12am UTC](https://meta.discourse.org/t/insert-text-or-images-anywhere-on-your-site-using-css-pseudo-elements/99200 "2018-10-11T11:12:34Z")

</div>

So, you want to insert some text or image in your Discourse site. Regarding the text in most cases it is sufficient to modify it from /admin/customize/site\_texts. Sometimes, however, it is our desire to add a sentence …

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

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