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 invites: Configuring how users can create and send invites for others to join your community
- Change user’s email: Changing a user's email address when they can't access their account
- Sign-up flow: Configuring and managing the sign-up flow with user approval
- Merge accounts: Merging user accounts
- Export users: Exporting users to a CSV file
- Bulk invites: Sending bulk user invites
- Welcome messages: Customizing trust level promotion messages for new users
- Custom fields: Creating and configuring custom user fields
- Poll result grouping: Grouping poll results by user custom field
- API fields: Adding non-visible user custom fields to the API
- Multiple accounts: Allow multiple accounts to register from the same IP address
- Theme selection: Allow users to select new color schemes
- Default notifications: Configuring Default Notification Settings for Users
- Find user by external ID: Finding a user by their identity provider 'external ID'
- Grant privileges: Grant Admin or Moderator Privileges to a User
- Impersonate user: Impersonate a user and returning to admin user
- Staff recognition: Make staff users more recognizable with customized avatars, posts, and mentions
- Recover user: Recover a user who was deleted as a spammer
- Reset bounce score: Reset a User's Bounce Score
- Message all users: Sending messages to all users on a Discourse site
- Helpful flags: Understanding "helpful flags" on user profiles
- Admin page access: Accessing a user’s admin page
- Delete account: Deleting a user account
Groups
- Create group: Creating groups in Discourse
- Invite to group: Invite users to a group
- Group owners: Add group owners to manage group membership
- Email domain groups: Add users to a group based on their email domain
- Group mentions: Allow groups to be mentioned and sent messages
- Group flair: Add group flair on member avatars
- User title link: Linking user titles to groups
- Primary group: Setting a primary group for users
- Group notifications: Configuring group notifications for a private category
- Private group: Configuring group access, membership, and visibility
- Custom field automation: Adding users to groups through custom field automation
- Bulk group additions: Adding users from groups to other groups in bulk
Badges
- About badges: Understanding and using badges
- Manual badge grant: Grant a badge to individual users manually
- Custom badge queries: Creating triggered custom badge queries
Content Settings
- Onebox configuration: Configuring and troubleshooting oneboxes
- Topic templates: Using topic templates for categories
- Page publishing: Page Publishing
- Embed selectors: Configuring allowed embed selectors
Customization
- Theme guide: Beginner's guide to using Discourse Themes
- Install theme: Installing a theme or theme component
- Theme components: Customizing your site with existing theme components
- Private repo theme: Installing a theme from a private Git repository
- CSS changes: Making custom CSS changes on your site
- Change font: Change the default font on your site
- Disable likes: Disable Likes
- Custom emoji: Configure custom emoji
- Syntax highlighting: Configure which programming languages are available for syntax highlighting
- Create banner: Creating a banner to display at the top of your site
- Customize Discobot: Customizing Discobot for your site
- Subcategory style: Customizing subcategory boxes in Discourse
- Customize text: Customize text in Discourse
- Translation keys: Find a translation key with verbose localization
- Update policies: Update the FAQ, Privacy Policy, and Terms of Service
- Customize header: Customize the header with links, icons, or menus
- User cards: Customize User Cards
- Site branding: Customize Your Site Branding
- FAQs and guidelines: Customizing FAQs and Guidelines
- Post notices: Understanding and managing post notices
Reporting & Data
- Dashboard reference: Admin dashboard report reference guide
- Site statistics: About Page Site Statistics Reference Guide
- User metrics: Understanding User Visits and Active Users in Discourse
- Search logs: Reference guide for the Search Logs page
Localization
- Multilingual structure: Structuring a multilingual community
- CJK search: Optimizing Discourse search for CJK languages
Privacy & Security
- Content security policy: Mitigate XSS Attacks with Content Security Policy
- Cookie consent: Cookie Consent, GDPR, and Discourse
- Permissions settings: Understanding groups and category permissions
Managing Files
- Uploads overview: Understanding Uploads, Images, and Attachments
- Broken uploads: Cleaning up uploads and purging uploads from S3
Site Promotion
- Discourse Discover: Including your site in Discourse Discover
- SEO overview: Discourse SEO overview (sitemap / robots.txt )
- Search indexing: How public Discourse sites are indexed by search engines like Google
- Google verification: Perform Google Search Console Verification with Discourse
- Web crawlers: Controlling Web Crawlers For a Site
- House ads: House Ad Templates
Automation
- Last checked: Setting up the 'Append last checked by' automation
- Last edited: Setting up the ‘Append last edited by’ automation
- Auto responder: Creating an auto responder automation
- New user trigger: Using the new user update automation
- AI triage: Discourse AI - AI triage
- Periodic summary reports: Discourse AI - Periodic summary reports
Discourse AI
- AI plugin: Discourse AI
- AI bot: Discourse AI - AI bot
- AI bot - Personas: AI bot - Personas
- AI bot - Chat and PM: AI bot - Chat and PM integration
- AI bot - Custom tools: AI bot - Custom tools
- AI search: Discourse AI - AI search
- Helper: Discourse AI - Helper
- Helper - Auto caption: Helper - Auto caption
- Helper - Chat thread titles: Helper - Automatic chat threads titles
- Related topics: Discourse AI - Related topics
- Sentiment: Discourse AI - Sentiment
- Summarize: Discourse AI - Summarize
- LLM settings: Discourse AI - Large Language Model (LLM) settings page
- LLM cost estimation: Estimating costs of using LLMs for Discourse AI
- Incoming email: Configuring incoming email to create new topics or group messages
- Email template: Customizing the Discourse outer email template
- Email customization: Customizing specific system email templates
- Interpolation keys: Interpolation Keys for Customizing Text and System Email Templates
- Email filtering: Remove extraneous content from incoming emails
- Mailing list mirror: Mirroring a read-only mailing list in Discourse
- Email troubleshooting: Troubleshooting Outgoing Email
General Configuration
- Admin interface: Understanding the admin interface
- Setup wizard: Rerunning the Discourse setup wizard
- Safe mode: Using Safe Mode to troubleshoot issues with themes and plugins
- Bootstrap mode: Understanding and managing bootstrap mode
- Admin login: Log back in as admin after locking yourself out with read-only mode or an invalid SSO configuration
- Activity summary: Configuring Activity Summary emails
- Private community: Configuring Discourse for a closed or private community
- Accessibility: Making your forum more accessible
- Mailing list: Using Discourse instead of an email mailing list
- Anonymous mode: Enable and configure anonymous mode
- Read-only modes: Read Only Modes in Discourse
- Beta versions: Understanding Discourse release channels
Managing Content
Topics & Posts
- Move posts: Moving posts to a new or existing topic
- Whisper posts: Creating a whisper post
- Wiki posts: Configuring wiki settings
- Post ownership: Changing ownership of posts
- Rebuild HTML: Rebuilding HTML on posts or topics
- Bulk actions: Performing bulk actions as a moderator
- Auto-bumping: Configuring auto-bumping for topics
- Topic timer: Scheduling topics for future publication
- Topic states: Understanding closed, unlisted, and archived topics
Categories
- Create category: Create a category in Discourse
- Category settings: Available settings within the category edit page
- Subcategory boxes: Display boxes for subcategories above topic list
- Anonymous posting: Configuring anonymous posting for specific categories
- Category order: Reordering categories and setting fixed category positions
- Delete category: Deleting a category
Tags
- Tags guide: Admin guide to tags in Discourse
- Structured tagging: Set up structured tagging with tag groups and category tag restrictions
Moderation
- Moderation guide: Discourse Moderation Guide
- Composer Messages: Composer Popup Messages Guide
- Flag priorities: Managing user reputation and flag priorities
- Watched words: Watched Words Reference Guide
- Regex watched words: Using Regex with Watched Words
- Spam prevention: Tips for Preventing Spam
- Spam detection: Setting up spam detection in your community
- NSFW detection: Setting up NSFW detection in your community
- Toxicity detection: Setting up toxicity detection in your community
- Nofollow links: Available site settings to configure "nofollow" for links posted by users