How to use Pearl Theme on multiple store views. Important update / install instructions

Starting with Pearl Theme release 1.5.5 (October 20, 2017), Frontend Options moved to the store view scope. Because of this, sharing the same theme and the same locale across multiple stores/store views will cause LESS/CSS files to overwrite each other, which can lead to design or functionality issues.

To avoid conflicts, ensure each store/store view has its own set of LESS/CSS files. Use one of the two approaches below.

Important note:

_If you upgraded from a version older than 1.5.5 by overwriting theme files, manually delete app/code/WeltPixel/FrontendOptions/view/frontend/web/css/source/_module.less. As of 1.5.5 this file is no longer used and will break LESS generation if it’s still present. All custom LESS generation was moved to view/frontend/web/css/source/_store_STORECODE_extend.less._

Option 1: Use different locale per store view

Assign a different locale (e.g., EN, FR, etc.) for each store view:

Stores → Configuration → General → General → Locale Options → Locale

Do not use the same locale for two different store views.

Option 2: Create a separate Pearl Child Theme for each store view

Use this if you must run multiple store views with the same language.

Step 1: Duplicate the child theme

Go to: /app/design/frontend/Pearl/

Duplicate the weltpixel_custom directory (including subfolders/files) and rename the copy, e.g. weltpixel_custom_storeview2.

Step 2: Update theme.xml

Edit /app/design/frontend/Pearl/weltpixel_custom_storeview2/theme.xml and set a clear title. Make sure the parent is Pearl/weltpixel_custom.

<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">
  <title>Custom Pearl Theme for Magento 2 - storeview 2</title>
  <parent>Pearl/weltpixel_custom</parent>
  <media>
    <preview_image>media/preview.png</preview_image>
  </media>
</theme>

Step 3: Register the new theme

Edit /app/design/frontend/Pearl/weltpixel_custom_storeview2/registration.php:

<?php
\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::THEME,
    'frontend/Pearl/weltpixel_custom_storeview2',
    __DIR__
);

Step 4: Apply the theme to the target store view

Go to Admin → Content → Configuration and assign your new child theme to the intended store/store view.

Updated on: 17/09/2025