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 Install here
you’ll see this
You can install popular Discourse theme components from the Popular tab, or import via your device or a repository link by clicking on the respective tabs.
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
- import the theme from the repository like we discussed above
- 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.