Theme translation dictionary example

This topic is a step-by-step tutorial to create a default en_US locale dictionary for a custom theme.

Change default strings

ExampleCorp created a custom orange theme that inherits from the Blank theme. When customizing their theme, they want to rephrase certain strings used in the Blank theme and modules for the default locale.

The following image shows a product view with default string values for .

ExampleCorp has a requirement to change the default strings to the following values:

• Change Add to Cart label to Purchase.
• Change Add to Compare label to Compare.
• Change Add to Wish List label to Wishlist.

To override the strings, ExampleCorp plans to use the en_US.csv dictionary file.

1. Run the i18n (internationalization) tool to generate the en_US dictionary for the orange theme:

   Copy
   bin/magento i18n:collect-phrases --output="app/design/frontend/ExampleCorp/orange/i18n/en_US.csv" app/design/frontend/ExampleCorp/orange
   Copied to your clipboard
   bin/magento i18n:collect-phrases --output="app/design/frontend/ExampleCorp/orange/i18n/en_US.csv" app/design/frontend/ExampleCorp/orange

2. Open the newly generated app/design/frontend/ExampleCorp/orange/i18n/en_US.csv file and add the following rows:

   Copy
   "Add to Cart", "Purchase"
   "Add to Compare", "Compare"
   "Add to Wish List", "Wishlist"
   Copied to your clipboard
   "Add to Cart", "Purchase"
   "Add to Compare", "Compare"
   "Add to Wish List", "Wishlist"

3. Run the deploy command to get localization changes:

   Copy
   bin/magento setup:static-content:deploy
   Copied to your clipboard
   bin/magento setup:static-content:deploy

Results

When ExampleCorp applies the orange theme, the custom strings are used instead of the default.

For example:

Last updated 9/11/2023

Was this helpful?

Yes

No