Apply and configure a storefront theme

What's in this topic

The topic describes how to apply a theme for your store. This is a required step if you want a theme to be used on a storefront. Also, it gives information how to add a theme independent logo for your store.

Prerequisites

Make sure that you set your Magento application to the developer mode.

Apply a theme

After you add your theme to the file system, you can apply it to your store. You apply a theme in Admin.

To apply a theme:

  1. In Admin, go to Stores > Configuration > Design.
  2. In the Store View drop-down field, select the store view where you want to apply the theme.
  3. On the Design Theme tab, select your newly created theme in the Design Theme drop-down.
  4. Click Save Config.
  5. If caching is enabled, clear the cache.
  6. To see your changes applied, reload the store front pages.

Add a design exception

Design exceptions enable you to specify an alternative theme for particular user-agents, instead of creating a separate store views for them. To add a design exception:

  1. In Admin, go to Stores > Configuration > Design.
  2. In the Scope drop-down field, select your website.
  3. On the Design Theme tab next to User-Agent Exceptions click Add.
  4. In the Search String box specify the user-agent using either normal strings or regular exceptions (PCRE). In the Design Theme drop-down list select the theme to be used for matching agent.
  5. Click Save Config.
  6. If caching is enabled, clear the cache.
  7. To see your changes applied, reload the store front pages.

You might want to set a permanent store logo, that displays on the store front no matter what theme is applied. To add a permanent theme-independent logo:

  1. In the Admin panel, go to Stores > Configuration > Design.
  2. In the Scope drop-down, select the store view.
  3. In the Design section of the General configuration, expand the Header tab.
  4. In the Logo Image field browse to the logo file saved in your file system.
  5. Upload the file.
  6. Click Save Config.
  7. If caching is enabled, clear the cache.
  8. To see your changes applied, reload the store front pages.

The logo you add here is stored in the /pub/media/logo/default/ directory.

To delete the permanent logo, go to the same location, select the check box next to the logo image, and click Delete.

Clear the cache

If caching is enabled in Magento Admin, you must clear the cache after you apply the theme, add a design exception, add a logo, and perform other tasks.

A system message notifies you that invalidated cache types must be refreshed.

  1. Click System > Cache Management.
  2. Clear the invalid cache types.

Troubleshooting (if the changes do not get applied)

If the changes you configure in the Admin are not applied after you clear the cache and reload the page, try the following:

  • Delete all files in the pub/static/frontend and var/view_preprocessed directories, then reload the pages. You can delete the files manually or run the grunt clean:<theme_name> command in CLI. For details about using Grunt in Magento see Installing and configuring Grunt.

  • In your Magento database, in the theme table, check if the type value for your custom theme is “0”. If it is “1” or “2”, change it to “0”. You can use a database tool such as phpMyAdmin or do it manually from the command line.