After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Using the Default Theme

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

The Magento Blank responsive theme renders the display of your storefront for different devices and incorporates best practices for desktop, table, and mobile devices. Some themes are designed to be used only with specific devices. When Magento detects a specific browser ID, or user agent, it uses the theme that is configured to be used for the specific browser. The search string can also include Perl-Compatible Regular Expressions (PCRE). To learn more, see User Agent.

Themes

Filter the theme grid

  1. On the Admin sidebar, go to Content > Design > Themes.

  2. Click Filters.

  3. Enter an ID range, theme name (or title), folder path, or parent theme.

  4. Click Apply Filters to update the list of themes.

View the current theme settings

  1. On the Admin sidebar, go to Content > Design > Themes.

  2. In the list of installed themes, find the theme that you want to examine and click the row to display the settings.

  3. To view a sample page, click the Theme Preview Image.

Preview theme

Apply a default theme

  1. On the Admin sidebar, go to Content > Design > Configuration.

  2. Find the store view that you want to configure and click Edit in the Action column.

  3. Under Default Theme, set Applied Theme to the one that you want to use for the current view.

    Applied Theme

  4. When complete, click Save Configuration.

Add a user agent rule

  1. On the Admin sidebar, go to Content > Design > Configuration.

  2. Under Design Rule, click Add New User Agent Rule.

    Design Rule

  3. For Search String, enter the browser ID for the specific device.

    Search strings are matched in the order they are entered. For example, for Firefox enter:

    /^mozilla/i

  4. Repeat the process to enter additional devices.

  5. When complete, click Save Configuration.