How do I 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:

Discourse Category Banners
Material Design Stock Theme
Moonclaw Theme port
Hamburger Theme Selector
Sam's personal "minimal" topic list design
Add /users to top nav
Discourse Vincent theme
Header submenus
Add /groups to top nav
Atlas, a simple blog-styled theme with an optional sidebar
Big Header - Little Header
TavoWEB theme for Discourse
Tiles Image Gallery
Night Mode Buttons
Custom hamburger menu links
Emoji mention theme component
Fakebook, a theme for social media lovers
Slick Image Gallery
Discourse Topic Status Filter
Discourse Vincent theme
Isabelle, an Animal Crossing inspired theme
Scrollable post content
Two nature-inspired color schemes
Discourse Tab Bar for Mobile
Having issues installing plugins
Google Fonts theme component
Topic Stopwatch
How to add links on home page menu to other site?
Topic List Excerpts Theme Component
Topic List Thumbnails Theme Component
Ghost, a cyberpunk theme for Discourse
Add Likes column
Discourse/discourse-segment-io-plugin installation
Jitsi video conference component
Whereby video meetings component
Unformatted Code Detector theme component
Peacock, a noble theme for Discourse :peacock:
StackBlur backgrounds
Thin header component
Discourse Button Styles
Elementary, a simple theme for Discourse
Add <abbr> tags to words in posts
Optional mobile title switch component
Homepage Feature Component
Is anyone working on a Discourse Wiki?
Trust-Level Avatar Flair
Topic list sidebar navigation
Unanswered Filter
Minimal, “classic” topic list design
Discourse Tag Banners
User Card Directory
Add Category Column
Script to enable Matomo analytics on Discourse
🌺 Hibiscus - Springtime Discourse theme
Alternative Voting Category Style
Category badge adjustment component
Daemonite Material Theme: Ample layout adjustments
Experiment on Meta: horizontal loading slider
Default Composer Category component
Raw post button
Intercom widget
Can't add new class to topic page elements using jQuery?
Font size for code inserts in posts
Custom source code formatting component
Alien Night Theme - A free Dark Theme for Discourse
Media Overlay component
"Last Seen" User Card
Minima, a minimal theme for Discourse
Omit Emoji component
Search Banner Component
Theme Switcher Component
HubSpot chat integration
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
Insert Video component
Warn admins/tl4 when replying to closed topics
[Deprecated] Copy Codeblocks Theme Component
Category Highlighter
Topic Template Placeholder Text theme component
Bugs theme-component
Discourse Units - Convert durations, lengths and masses
Category Groups component
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
Topic Count in Category Boxes Theme Component
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
Inline pdf previews
[Deprecated] Submit from Preview (Mobile)
Insert Link to External Website
Custom header links (icons)
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
Social Share Component
Category icons component
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
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
Baidu Search component
Discourse Dice Roller
Show original poster avatars on mobile
Category List with Banners
Zeronoise. A theme aiming to create a pleasant reading experience
Discourse-Compact-Nav Component
🎀 Neomorphism, a modern theme for Discourse
:snowman_with_snow: Olaf, a Frozen inspired theme for Discourse
Warning banner for old Android devices affected by Let's Encrypt changes
"Open external links in a new tab by default" not working
Upgrade Docker Failed
Popsicle, a cool theme for Discourse :dango:
Showcased Categories Theme Component
How can I add a menu item
:santa: Santa, a Christmas theme for Discourse
Christmas Decoration Component :christmas_tree:
Christmas hats component
Kanban Board Theme Component
Solarized, a dark theme for Discourse
Discourse Docs Card Filter Component
Clickable Social Icon Links on Profile
Fireworks Component :fireworks:
Grogu, a theme inspired by "The Mandalorian"
Custom Loading Spinner Component
Mario inspired theme for Discourse
Featured Tiles Theme Component
Mint, a modern theme for Discourse :herb:
Left side hamburger menu on mobile
MD Composer extras
☁️ Discourse Air Theme
Yotsaba A Theme
Discourse Sidebar Tags Component
Landing Pages Blog :small_airplane:
DiscoTOC - automatic table of contents
Display replies and likes count in mobile view
Discourse Signup Banner Component
Add a New Message button to the PM notification menu
Set up a Discourse instance, install plugins and a new theme
Dark Admin Editor
Wikified Posts Component
Avid Reader: A theme focused on readability
Custom Homepage for Groups
Discourse Coloring Tag
Blog Post Styling
Custom Admin Toolbox
:classical_building: Rome, a theme inspired by ancient roman manuscripts
How is the Banner at created?
Timeline bookmark button
Alternative icons
Discourse Trendy Login
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
Discourse hamburger tags
Set up a Discourse instance, install plugins and a new theme
Halloween Decorations Component :ghost:
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?
Featured Categories Header
Red-light theme
Mobile Category List Adjustments
Scroll to Top Component
How to get Solidity syntax highlighting
Topic List Thumbnails Theme Component
Self Service Badges?
Change the Like icon to :+1:
Sunflower, A discourse theme
Require Edit Reason
Link on Top header to Go to Home page of main site
Discourse Vincent theme
Discourse optional Apple iOS hardware Keyboard support
Timeline mute button
Christmas hats component
A graceful theme for Discourse
Failing to rebuild app on Discourse since May 7
IFrame Lightboxes
Custom Category Boxes Component
Post Badges component
Discourse Topic Author
Avatar size and shape
Custom header links (icons)
(+ New topic) button on all pages
Dracula a Dark Theme for Discourse

3 posts were merged into an existing topic: Why Can’t I Add a Theme Component to a Theme?