Translations
Valotrix Cart Rewards detects the customer's active language from their Shopify Markets configuration and shows widget copy, Custom Block copy, and checkout confirmation copy in that language.
Translations live in three layers, each with a different setup story:
- Widget copy you write (toast titles, popup CTA, progress bar messages) - translated by you, per campaign, in the rule editor.
- Custom Blocks - ship pre-translated in 4 locales (English, German, Spanish, French). Custom copy you add on a block also needs to be translated per locale.
- Checkout confirmation banners (Plus) - ship pre-translated in 8 locales (English, German, Spanish, French, Italian, Japanese, Portuguese, Chinese). You don't edit these; they switch automatically based on the shopper's Shopify Markets language.
How to translate widget copy (per rule)
In the rule editor, scroll to the Messaging tab (the rule editor's last tab). Each widget format has its own text fields with a locale switcher at the top.
- Click the locale switcher and pick the language you want to add (e.g.
defor German,fr-CAfor Canadian French). - Translate each text field - title, body, CTA label - into the target language.
- Save the rule. Valotrix Cart Rewards stores these as the rule's
_translationsper locale. - Repeat for every locale your store supports.
The list of available locales in the switcher comes from your Shopify Markets locale list. If you don't see a language you expected, add it as a published market language in Settings → Markets in the Shopify admin first.
Custom Block translations
The seven Custom Blocks (threshold bar, PDP gift preview, PDP buy-get pairing, urgency banner, inline tier stack, collection eligibility overlay, gift unlock celebration) ship pre-translated in 4 locales: English, German, Spanish, French. Static labels (button text, error states, accessibility labels) switch automatically based on the shopper's locale - no setup required.
Custom copy you've added to a specific block (your own headline, your own CTA) needs translation per locale the same way as widget copy: open the block in the admin, find the Messaging or Copy tab, and use the locale switcher.
For locales beyond the 4 pre-translated ones, the block falls back to English for the static labels. You can still translate your custom copy into any locale your Shopify Markets list supports - the fallback only applies to the built-in labels.
Checkout extension translations (Plus only)
The Plus-only gift confirmation banner across the checkout (delivery-address, shipping-option, payment-method, thank-you steps) is pre-translated in 8 locales. The shopper sees the banner in whichever language matches their Shopify Markets language - no setup, no per-rule configuration.
Merchants don't edit these. The strings are part of the Valotrix Cart Rewards extension itself and update automatically when Valotrix Cart Rewards ships new versions. The supported locales are: English, German, Spanish, French, Italian, Japanese, Portuguese, Chinese.
Fallback behavior
If a shopper's locale isn't translated, Valotrix Cart Rewards falls back to the default locale for that store (typically English, configurable in Shopify Markets). The fallback is whatever language you originally entered when creating the campaign.
For example: you create a campaign in English, add a German translation, but leave French untranslated. A French shopper sees the English copy, not a broken or empty widget.
Built-in vs custom: a recap
| Layer | Pre-translated locales | What you translate |
|---|---|---|
| Widget copy (toast, popup, progress, choice, reminder) | None - Valotrix Cart Rewards doesn't write your campaign copy | Everything you enter, per locale |
| Custom Block built-in labels | 4 (en, de, es, fr) | Nothing - labels switch automatically |
| Custom Block custom copy | None | Everything you enter, per locale |
| Checkout extension banners (Plus) | 8 (en, de, es, fr, it, ja, pt, zh) | Nothing - fully automatic |