Articles on: Magento 2 Pearl Theme User Guide

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


  1. 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.


  1. 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"


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


  1. Place the file into:


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


  1. 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.


  1. 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.


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


  1. Translate only the second column values while keeping the format intact.

Example:

"Custom Footer","Benutzerdefinierte Fußzeile"


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


  1. 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



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

Updated on: 16/09/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!