Manage themes

Reading time: 2 minutes

Theme Manager

Since Mautic 2.1.0, the Theme Manager was added and you can access it via the Admin Menu (click the cog icon in the top right corner to open it), select the Theme menu item.

The table of installed themes shows you the name of the theme, the author name and the link to his website if provided and what features the theme provides. There is also preview (if provided) to see the screenshot of the theme under the arrow next to the theme name.

Install new theme

A new theme can be installed as a zip package. The zip package must have the same structure as the themes preinstalled at Mautic. Than means there must be the config.json file present in the root folder of the zip package. More on that can be found in the developer documentation.

If you have the theme zip package either created by yourself or downloaded from a theme provider, in the top right corner of the Themes page is the upload form. Click the "Choose File" button to choose the zip file, then click Install. The notice will appear if the installation was successful and if so, the new theme appears in the table of currently installed themes.

Download an existing theme

If you want to create your own theme, the simplest way to do that is to download an existing theme and modify it. The download option is in the drop down menu next to every theme in the Theme Manager table.

Update an old theme

The old theme files will be overwritten by the new one when installing a theme which already exists in your Mautic. Therefore, the theme updates can be also done by the Theme Manager's Install form.

The pre-installed themes cannot be overwritten because the changes would return again after a Mautic update.

Delete a theme

Go to the Theme Manager, check what theme(s) you want to delete and then click the red button above the theme table to delete them.

The pre-installed themes cannot be deleted because they would appear again after a Mautic update.

Assigning a default theme

It is possible to assign a default theme to a Mautic instance by editing the global configuration. To access the global configuration you must be logged in with sufficient access. Click on the cog icon beside the logged in user, and select 'Configuration'.

From the configuration screen, the available themes will be listed in a dropdown box, which can be selected. On saving, this setting will apply for all resources which do not have a theme explicitly specified.

Configure themes under Administration Settings->System Settings

Themes are available for emails and landing pages on each one's main editing page

Select a theme for a new page

Found errors? Think you can improve this documentation? edit this page