Installing a Theme

How to install a theme.

Installing a theme that someone else has created is easy. Once you have the theme files on your machine, do the following:

1. Drop the theme folder into your site’s _themes directory
2. Open _config/settings.yaml and change the value of _theme to the name of the new theme
3. Optionally, if your theme came with a theme.yaml file, change any settings you feel need changing

Refresh your site and you should see the new theme.

When Switching Themes

A theme contains all of the layouts and templates that your content will use. They’re mostly plug-and-play, but if you’re switching your site from one theme to another, there’s something you must remember: Statamic is open-ended on what you name things. The templates that come with a new theme might not match those of your old theme.

If that’s the case, you have two options:

• Update your content files to use the correct new theme name
• Change the theme’s template file names to match the ones used by your content