Install a theme or theme component

Importing new themes and theme components

head to Admin → Customize → Themes and press the Install button.

From the Install dialog, you can …

  • choose popular Discourse themes and theme components
  • install from a Git repository URL link
  • install from your local device (rare)

If you are installing a complete theme, you’re done!

If you install a theme component :jigsaw:, you will need to add that theme component to your active themes. Keep reading.

Add theme components to a theme

Let’s say you want to use the Discourse category banners theme component.

  1. Import the theme from the repository.
  2. Add it as a theme component to your active / user-selectable themes.

You can also components to your themes using the “Include component on these themes” setting:

You can also add components from a theme’s overview using the “Included components” setting:

Automatic updates

Sometimes the themes or components you install will have updates. They should auto-update by default, however, if they do not, you can manually update via the “update to latest” button.


If you prefer to install themes from the command line, see this topic. If you’d like to learn more about the Discourse theme system, see:

Moonclaw Theme port
Add /users to top nav
Discourse Vincent theme
Custom Hamburger Menu Links
Emoji mention theme component
Slick Image Gallery
Grogu, a theme inspired by "The Mandalorian"
TavoWEB theme for Discourse
Big Header - Little Header
Atlas, a simple blog-styled theme with an optional sidebar
Add /groups to top nav
Tiles Image Gallery
Night Mode Buttons
Header Submenus
Two nature-inspired color schemes
Discourse Tab Bar for Mobile
Having issues installing plugins
Topic Stopwatch
How to add links on home page menu to other site?
Ghost, a cyberpunk theme for Discourse
Discourse/discourse-segment-io-plugin installation
Peacock, a noble theme for Discourse :peacock:
StackBlur backgrounds
Discourse Button Styles
Elementary, a simple theme for Discourse
Featured Cards component
Add <abbr> tags to words in posts
Is anyone working on a Discourse Wiki?
Trust-Level Avatar Flair
Topic list sidebar navigation
Minimal, “classic” topic list design
Discourse Coloured Text
Alternative Voting Category Style
Category badge adjustment component
Daemonite Material Theme: Ample layout adjustments
Default Composer Category component
Raw Post Button
Can't add new class to topic page elements using jQuery?
Font size for code inserts in posts
Media Overlay component
"Last Seen" User Card
Minima, a minimal theme for Discourse
Omit Emoji component
Set up a Discourse instance, install plugins and a new theme
Theme Switcher Component
Dark Mode Automatic Theme Switcher
Live Topic Timer
Segment Tracking Theme Component
Custom Header Links
Place for total coding beginners to learn how to customise?
Highlight text Theme Component
Discourse Category Headers theme component
Categories Layout Override
Rainbow, a colorful theme for Discourse :rainbow:
Add category links Theme Component
Warn admins/tl4 when replying to closed topics
Theme Stelpolva: A discourse rounded theme based on Default Theme
Group specific tool bar
Desktop to Mobile View Banner
Category Highlighter
Topic Template Placeholder Text theme component
Bugs theme-component
Discourse Units - Convert durations, lengths and masses
Discourse Tag Cloud
Featured Flip Cards
D3 Graphviz Theme Component
Star Wars theme
Toggle Whisper :eye:
Essential, a simple theme for Discourse :art:
Set up a Discourse instance, install plugins and a new theme
Extended About Page
Radiant, an elegant theme for Discourse
Category Hider Theme Component
Modest, a minimal theme for Discourse
Geometric, a dark theme for Discourse
Component 2. A UI-Light Theme for Discourse
Cannot install plugin - nothing happens
Theme component to use "Category icons" in "Events plugin" calendar
Enhanced category-box display component
Yotsaba B Theme
How can I add a analytics script into the header of my community?
Expanded Create Topic Component
FKB Pro - Social theme
Insert Link to External Website
How do I integrate ? in meinen Forum?
Fire & Ice, a theme for Discourse :fire: :ice_cube:
Custom header colour and category icons and login button
Discourse Web Page Watermark
Category Icons
Hide Likes For New Users
How to remove the number of months in the category section
Set up a Discourse instance, install plugins and a new theme
Reply Template
How is this new topic button achieved?
Dark Blue theme
Masonry Image Gallery
Adding a theme component to a multisite installation?
Video Upload to YouTube and Vimeo using Theme Component
Set up a Discourse instance, install plugins and a new theme
Category List with Banners
🎀 Neomorphism, a modern theme for Discourse
:snowman_with_snow: Olaf, a Frozen inspired theme for Discourse
OrgChart component
"Open external links in a new tab by default" not working
Upgrade Docker Failed
Popsicle, a cool theme for Discourse :dango:
How can I add a menu item
:santa: Santa, a Christmas theme for Discourse
Christmas Decoration Component :christmas_tree:
Christmas hats component
Solarized, a dark theme for Discourse
Clickable Social Icon Links on Profile
Fireworks Component :fireworks:
Custom Loading Spinner Component
Mario inspired theme for Discourse
Left side hamburger menu on mobile
MD Composer extras
Versatile Showcase
Yotsaba A Theme
DiscoTOC - automatic table of contents
Display replies and likes count in mobile view
Set up a Discourse instance, install plugins and a new theme
Set up a Discourse instance, install plugins and a new theme
Featured Categories Header
Wikified Posts Component
Set up a Discourse instance, install plugins and a new theme
Avid Reader: A theme focused on readability
Discourse Coloring Tag
Landing Pages Blog :small_airplane:
🖋 Inky, a theme to make reading easy
Blog Post Styling
MD Topic List component
MD Topic List Mobile component
Custom Admin Toolbox
:classical_building: Rome, a theme inspired by ancient roman manuscripts
How is the Banner at created?
Timeline bookmark button
Alternative icons
Set up a Discourse instance, install plugins and a new theme
Set up a Discourse instance, install plugins and a new theme
Discourse hamburger tags
Set up a Discourse instance, install plugins and a new theme
Set up a Discourse instance, install plugins and a new theme
Set up a Discourse instance, install plugins and a new theme
👅 Markdown Flavors
How do I test drive UI changes?
Colored Tag Styles
Voice Recorder Component
Topic Banners component
Discourse Show Fullname in Mentions
Post Badges
Custom Homepage
Matomo Analytics
What is the name of this theme?
Insert Video
Discourse Solved Quote Customization
Rounded Borders for images, oneboxes, blockquotes & more
Guest Gate Theme Component
Offline Indicator Theme Component
Submit from Preview (Mobile)
Landing Pages Blog :small_airplane:
Sticky Avatars for Mobile
Social Share
DarkPixlz's Modern Theme
Custom Lightbox
Sticky New Topic Banner
How to Set a Closable Banner at the Top of site?
Copy Codeblocks Theme Component
Search results page displays topics title that I cannot click
Blackout - A Theme For OLED Displays
Horizontal loading slider
Composer Footnote Button
Account Deletion Request
Desktop PWA Navigation
Lightweight Topic List Container
Buttons for Scrolling to the Top/Bottom of Topics
Setup HubSpot chat Integration
Floating Navigation Controls and Desktop Navigation Bar for Mobile
Watched Words to serve as shortcut command to insert links
DiscourseConnect Signup Button
🌐 www theme
Topic List Previews Theme Component
Dark Admin Editor
Topic List Previews Theme Component
Red-light theme
Mobile Category List Adjustments
Scroll to Top Component
How to get Solidity syntax highlighting
Self Service Badges?
Change the Like Icon to :+1:
Land on Group Messages Component
Sunflower, A discourse theme
Require Edit Reason
Link on Top header to Go to Home page of main site
Discourse Vincent theme
Timeline mute button
Christmas hats component
Failing to rebuild app on Discourse since May 7
IFrame Lightboxes
Custom Header Links (icons)
(+ New topic) button on all pages
Dracula a Dark Theme for Discourse
Discourse Vincent theme
Isabelle, an Animal Crossing inspired theme