How do I install a Theme or Theme Component?


(Sam Saffron) #1

Importing new themes and theme components

To import new themes and components, visit

or via the UI head to Admin > Customize > Themes

Then click on import here

you’ll see this

You can then import theme files from your device or via a theme repository link. The repository link for each theme is provided by the author on the theme topic. There are also options to import from a specific branch and to specify whether the repository is private.

If you import a theme component, you need to also add it to your actives themes. This is covered in detail in the next section

Add theme components to a theme

Let’s say you like the Discourse category banners theme component and want to use it. You would proceed as follows

  1. import the theme from the repository like we discussed above
  2. add it as a theme component to your active / user-selectable themes

You can do that like so:

After importing the component, go to the theme you want to add it to and look for the Theme components section

This list will show all installed theme components. From there you can add theme components to the theme. If we add the Discourse category banners theme component it would look like so

If you have more than one user-selectable themes, you would need to add the component to all of them like we did above.

Checking for updates

Sometimes the themes or components you install will have updates.

If a theme or component has updates, an icon will display next to its name like so

If you select that theme or component you can update it with one click by clicking on the update button here:

This should cover everything you need to install a theme or theme component. If you'd like to learn more about the Discourse theme system, we have a more detailed guide that should provide you with a general overview with more details.

Material Design Stock Theme
Moonclaw Theme port
Hamburger Theme Selector
Sam's personal "minimal" topic list design
Discourse Category Banners
Add /users to top nav
Customization of discourse
An alternate dark theme
Discourse Vincent theme
FlexFooter component
Big Header - Little Header
Easy responsive footer
Header submenus
Custom Header Links
Night Mode Buttons
FlexFooter component
Emoji mention theme component
Custom hamburger menu links
Custom top navigation links
How do I get this design?
Add /groups to top nav
Topic Stopwatch
Mobile user-cards
Category icons component
Optional mobile title switch component
Add Category Column
Minimal, “classic” topic list design
Change the Like icon
Trust-Level Avatar Flair
Add <abbr> tags to words in posts
Altering default buttons in topic
Intercom widget
Alternative Voting Category Style
Script to enable Matomo analytics on Discourse
Banner themes (and instructions for customizing them)
Minima, a minimal theme for Discourse
Discourse Vincent theme
Topic list sidebar navigation
Discourse Category Sidebars
Alternative logo for dark themes
A graceful theme for Discourse
Brand header theme component
Discourse Youtube player
Discourse Tab Bar for Mobile
Discourse Tag Sidebar
Discourse Cookie Consent Banner
Fakebook, a theme for social media lovers
Iframe Lightboxes
Versatile Banner
Discourse Button Styles
Custom hamburger menu links
Tag icons component
Tiles Image Gallery
Iconified Header Links
TavoWEB theme for Discourse
Iconified Header Links
Custom source code formatting component
Tiles Image Gallery
(+ New topic) button on all pages
Thin header component
StackBlur backgrounds
Linkify words in post
Warn admins when replying to closed topics
Font size theme
Dark Admin Editor Component
Category badge adjustment component
Avatar size and shape
Daemonite Material Theme: Ample layout adjustments
Christmas hats component
Discourse Vincent theme
DEPRECATED: Discourse masonry gallery theme component
DEPRECATED: Discourse masonry gallery theme component
"Last Seen" User Card
Media Overlay component
Slick Image Gallery