Localisation and Translation

The Localisation and Translation feature lets you create content in multiple languages for your components. If you sell to customers in different countries, you can show them messages, buttons, and content in their own language automatically.

Example: A customer in France sees "Livraison gratuite" while a customer in the US sees "Free shipping" - all from the same component! 1

Only v3 components or above support this feature.

How to Set It Up

Step 1: Access Product Mapping

create or edit any v3 component in the Shopify app
Find the translations and locales button, it should say "English" by default. Click on it.
Click the "Add language" button
Select a language from the modal menu

Step 2: Switch Between Languages

Once you've added languages, you can edit content for each one. First you will need to swap over to your new language:

Click on the translations and locales button
Select the language you want to translate from the dropdown menu
All text fields in your component will now switch to the content for the selected language
Empty fields will show your default language as a placeholder (so you can see what to translate)

What fields can be translated?

Headers and subheaders
Any customer-facing text in your components

What fields CANNOT be translated?

Images and image URLs
Dropdown options
Checkbox settings
Date fields
Link URLs

Step 4: Track Translation Progress

The system helps you keep track of your translation work:

Green "Complete" badge = All fields are translated
Yellow "X% translated" badge = Some fields still need translation
Gray "Not started" badge = No translations yet
Progress bars show exactly how much is done

What Your Customers See

When a customer visits your checkout: