> ## 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 translate the Pearl Theme, WeltPixel module or Magento 2  in another language.

You can translate the **Pearl Theme**, **WeltPixel modules**, and **Magento 2** into another language using Magento’s built-in translation system.

---

## A. Translate Pearl Theme

1. From the root of your Magento installation, run the following command to export all theme and Magento phrases:  

       php bin/magento i18n:collect-phrases --output="dictionary.csv" -m

2. Locate the generated `dictionary.csv` file in your Magento root directory.  
   - The file contains **four columns**.  
   - Keep only the **first two columns** (both contain English text). Delete the rest.

3. Using a text editor, translate only the **second column** values (between quotes `" "`).  
   - Ensure each entry starts and ends with double quotes, separated by a **comma ( , )**.  
   - Example:  
     `"Custom Footer","Benutzerdefinierte Fußzeile"`

4. Rename the file to match the **Magento locale format**:  
   - Example: `fr_FR.csv`, `it_IT.csv`  
   - Locale names are **case-sensitive**.

5. Place the file into:  

       app/design/frontend/Pearl/weltpixel_custom/i18n/

6. Make sure your Magento locale is configured:
   - **Frontend translations**: Go to **Stores → Configuration → General → Locale Options → Locale** and select your language.  
   - **Backend translations**: Go to **Account Settings → Account Information → Interface Locale** and select your language.

7. Refresh all Magento caches and check your storefront/backend.

---

## B. Translate a WeltPixel Module

1. Navigate to the module’s translation folder:  

       app/code/WeltPixel/ModuleName/i18n

   Here you should find `en_US.csv`.

2. Copy the file and rename it using the **Magento locale format** (e.g., `fr_FR.csv`, `it_IT.csv`).  

3. Translate only the **second column** values while keeping the format intact.  
   Example:  
   `"Custom Footer","Benutzerdefinierte Fußzeile"`

4. Configure locales as in Section A:  
   - **Frontend**: **Stores → Configuration → General → Locale Options → Locale**  
   - **Backend**: **Account Settings → Account Information → Interface Locale**

5. Refresh Magento caches and confirm translations on the storefront.

---

## C. Translate Magento 2 Core (Language Packs)

For translating Magento core files or applying a complete **language pack**, refer to the official Magento documentation:  
[Magento DevDocs: Translations and Language Packs](https://devdocs.magento.com/guides/v2.4/frontend-dev-guide/translations/xlate.html)

---

✅ Following these steps will let you translate the Pearl Theme, WeltPixel modules, and Magento 2 itself into your desired language.