> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weltpixel.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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`.

```xml
<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
<?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.

![pearl-multiple-store-view-theme-configuration.png](https://storage.crisp.chat/users/helpdesk/website/-/b/3/4/4/b344736dea5fe000/2eb4c928-2614-4d85-9ccb-81ca14_vnb8rz.png)