How to install a new theme?

Publii stores themes in two places:

• in the Publii/themes directory, where all themes currently installed in the Publii app are stored and these themes are available to use in all websites available in your Publii installation,
• inside each website's input folder, which includes a theme directory which only stores the theme files used on that specific website.

In this case you can have older version of the theme in your site, than the version currently installed in Publii. It protects your websites before unintended update of the themes.

To install a new theme in your Publii website, you have to make two operations:

1. Install the new theme in Publii, to make it available for all websites
2. Select and install previously installed theme on the selected website.

Installing a new theme in Publii

To make a new theme available in the Publii app, go to the application settings and drag and drop the folder or ZIP archive with the new theme's files over the themes list. Publii will automatically move the unzipped files to the application themes directory.

Installing a theme on your website

To install the theme on your website, navigate to the settings tab and, in the dropdown list of available themes, select to either "Install and use" or "Use" your chosen theme (depending on whether it has already been installed or not).

If you decide to install a new theme on your website, Publii will copy the theme files from the application themes directory.

If theme with the same name exists on your website - the newly installed one will overwrite it. Please remember - if your theme contains any custom changes - you will loose them during this operation. We strongly recommend to use theme overrides for any changes related to the theme code. Thanks to use of theme overrides, your custom changes are safe during theme update process.

An alternative solution is to manually copy the theme directory of your chosen theme in the website's input/themes directory.