How do I install a Theme or Theme Component?


(Sam Saffron) #1

To install a theme:

  • Head to or via the UI head to Admin -> Customize

  • Click the Import button

  • Select “From the web”

  • Enter the URL of the theme as described on the theme: for example

  • Click Import

Once done you will have your theme or theme component imported. You will be able to check for updates and update the theme using the UI.

:warning: Note: imported theme components don’t do anything until you add them to a theme. If your newly imported theme component “isn’t working”, first check that you’ve added it to your current theme.

Material Design Stock Theme
Moonclaw Theme port
Hamburger Theme Selector
Sam's personal "minimal" topic list design
Add /users to top nav
An alternate dark theme
Customization of discourse
Topic Stopwatch
Discourse Vincent theme
FlexFooter component
Discourse Category Banners
Simple category sidebar
Slick Image Gallery
Discourse Vincent theme
Christmas hats component
Custom top navigation links
Big Header - Little Header
Header submenus
How do I get this design?
Add /groups to top nav
Custom hamburger menu links
Media Overlay component
Easy responsive footer
Emoji mention theme component
FlexFooter component
Night Mode Buttons
Custom Header Links
Brand header theme component
Discourse Tab Bar for Mobile
Linkify words in post
Minimal, “classic” topic list design
Change the Like icon
Trust-Level Avatar Flair
Add <abbr> tags to words in posts
Smart mobile header
Altering default buttons in topic
Alternative Voting Category Style
Script to enable Matomo analytics on Discourse
Banner themes (and instructions for customizing them)
DEPRECATED: Focus - Full-screen composer mode
Topic list sidebar navigation
Alternative logo for dark themes
A graceful theme for Discourse
LazyLoad images
Discourse Youtube player
Iframe Lightboxes
Discourse Button Styles
Custom hamburger menu links
Tiles Image Gallery
Iconified Header Links
Iconified Header Links
Tiles Image Gallery
(+ New topic) button on all pages
Thin header component
Subtle Image Expansion Hint for Mobile
StackBlur backgrounds
Add Category Column
Warn admins when replying to closed topics
Font size theme
Dark Admin Editor Component
"Last Seen" User Card
DEPRECATED: Discourse masonry gallery theme component
Discourse Vincent theme
DEPRECATED: Discourse masonry gallery theme component

after a theme is selected via the menu, the menu disappears

EDIT: I’ve fixed it by adding other themes as its components

(Blu McCormick) #3

If theme settings are added by the theme author, will they just appear for the person importing the theme or does the importer need to take an extra step to access the settings? Where would the settings for the theme be found? Thanks in advance (and please delete from here if confusing to other members).

(Vinoth Kannan) #4

No need for any extra steps. You can find the settings in that theme page itself.

(Blu McCormick) #5

This page?

(Vinoth Kannan) #6

Yes. Below to the “Uploads” block. You could try it yourself with this theme component.

(Blu McCormick) #7

Thanks. These are the settings I am looking for:


Since I don’t see them under “upload” I’ll wait on the author’s input.

(Vinoth Kannan) #8

It looks like theme settings are introduced two days ago for that theme. Maybe you are not in the latest version. If you already upgraded it then try by refreshing the page in browser.

(Blu McCormick) #9

Do you mean the forum software or the theme because I just downloaded this theme before posting here.

(Vinoth Kannan) #10

That imported theme.

(Blu McCormick) #11

Thanks. I checked for updates for the theme and child theme.


No change.

(Vinoth Kannan) #12

Yes. Your forum must be in latest version too :slightly_smiling_face:. To have this feature.

(Joe) #14

11 posts were split to a new topic: Adding theme components not working. Results in an empty box

(Joe) #25

A post was split to a new topic: User preferences page leads to 404

(Martin Cole) #29

Hi Done this with the brand header and preview is fine.
Go back to my forum and nothing has changed?
Do I have to save?
I cant see a save button or anything like that. I only have a button saying
Preview - Export - Make Theme - Delete

Reading from your instructions there is nothing do/save to then show the preview as live?

Clearly I must be missing something

(Vinoth Kannan) #30

You should add it to your existing theme under “Theme Components” list.

(Martin Cole) #31


I could not get it to work so I downloaded it then uploaded it then set it up again and then all OK. If it tried to do it from URL then it showed preview but did not update the site.


This wasn’t working for me; added components always ended up as themes, which meant I couldn’t combine any of them. It confused the heck out of me.

I had to press the “convert” button on them before they became usable.

(Joe) #33

That’s because the component you’re trying to add does not have the component flag in the about.json file.

A while back we sent PRs to all theme components here on Meta to get them updated to work with this. Most them have been merged by the authors but sadly there may be some where the PRs have not been merged yet.

Can you share a link to the component you’re trying to use?


Thanks, that’s useful to know.

I had this issue with the following: