Language & Localization — Translating the Order Editing Experience

Purpose

Answer a high-intent merchant question:

“How do I change the language, text, and wording customers see during order editing?”

This article covers localization, translations, and wording control across the Account Editor widget, emails, cancellation reasons, and upsell flows.

⭐ Why This Matters

Language issues are one of the top causes of merchant confusion and customer drop-off.

Without proper localization:

• Customers see mixed or incorrect languages
• CTA text feels generic or unclear
• Cancellation reasons don’t match store tone
• International shoppers lose trust

Correct localization:

• Improves conversion and retention
• Reduces support tickets (“Can I change this text?”)
• Makes Account Editor feel native to the store

🌍 How Localization Works in Account Editor

Account Editor uses key-based localization, not hardcoded text.

This means:

• Every visible string has a translation key
• You can safely edit text without breaking logic
• Multi-language stores can serve the correct language automatically

Localization applies to:

• Order editing widget
• Upsells
• Cancellation retention
• Error messages
• Button labels
• Customer-facing prompts

🗂️ Localization Settings Overview

Path:

Account Editor Admin → Language & Localization

From here, you can:

• Search and edit text keys
• Customize wording per language
• Match your store’s tone (friendly, premium, B2B)
• Translate cancellation reasons and CTAs

🔍 Editing Language Strings (Key-Based System)

How It Works

Each piece of customer-facing text is mapped to a localization key.

Example:

• btn_confirm_edit
• cr_reason_changed_mind
• upsell_accept_button

You update the value, not the key.

Step-by-Step: Editing Text

1. Open Language & Localization
2. Use the search bar to find relevant keys

(e.g., “cancel”, “button”, “address”)

3. Update the text value
4. Save changes
5. Refresh storefront preview

Best Practices

• Keep text short and clear
• Avoid emojis or excessive punctuation
• Match brand tone across all surfaces
• Don’t remove variables (e.g. {{countdown_timer}})

🌐 Multi-Language Stores (Shopify Markets)

Account Editor automatically detects:

• Customer language
• Storefront language
• Shopify Markets configuration

If multiple languages are enabled:

• The correct language version is shown automatically
• No manual switching is required per order

Multiple language values for the same localization key

📌 Important:

If a translation is missing, Account Editor falls back to the default language.

❌ Cancellation Reasons Localization

Cancellation reasons are fully translatable.

Where to Edit

Search for keys tagged with:

cr

These control:

• Reason labels
• Confirmation prompts
• Retention flow messaging

Example

Default:

“Changed my mind”

Localized:

“Je n’ai plus besoin de cet article”

🧠 Upsells, Buttons & CTA Localization

Buttons and CTAs are often the highest-impact text.

You can localize:

• Upsell accept buttons
• Decline text
• Confirmation messages

Example:

• EN: “Add to my order”
• FR: “Ajouter à ma commande”
• DE: “Zur Bestellung hinzufügen”

🌐 Translating Upsell Offer Copy

Each upsell offer's copy can be translated per language so the whole offer feels native to international shoppers. You set this in the offer builder under Step 2 → Languages ("Multi-language content").

What you can translate per language:

• Offer headline
• Offer description
• Accept button text
• Decline button text

Supported languages include English, German, Spanish, French, Italian, Dutch, Swedish, and Japanese. Any untranslated string falls back to your default-language copy.

Note: The static badge and review count are single shop-wide values (set in Upsells → Settings), not translated per offer. Free-shipping bar messages can be customized per market (a different message per country) via the offer's market overrides.

Tip: Localize intent, not literal wording — a headline that converts in English may need rephrasing for German or Japanese.

![

Upsell offer Step 2 "Languages" panel showing per-language Headline, Description, Accept button, and Decline button fields ](https://storage.crisp.chat/users/helpdesk/website/-/e/5/a/f/e5af1a5ea93f4000/image_y0r2lf.png)

🧪 Real Merchant Scenarios

Scenario A — “Widget shows English on French store”

Cause:

French translation keys not filled.

Fix:

Add French values or enable fallback intentionally.

Scenario B — “Cancellation reasons don’t match brand tone”

Cause:

Default generic text used.

Fix:

Rewrite reason values to match store voice.

Scenario C — “Upsell button feels too aggressive”

Cause:

Direct translation from English.

Fix:

Localize intent, not literal wording.

❓ FAQs

Q: Can I fully rewrite all customer-facing text?

Yes. All visible strings are editable.

Q: Will this affect logic or tracking?

No. Only text values change — logic stays intact.

Q: Do I need a translation app?

No. Account Editor handles localization internally.

Q: What happens if I delete a value?

The system falls back to the default language.

⚠️ Common Issues & Fixes

🔗 Related Guides

→ General Settings — Edit Window & Limits

→ Email Notifications Settings

→ Cancellation Retention

→ Upsell Setup & CTAs

✅ Key Takeaway

Localization is not optional for modern Shopify stores.

Proper Language & Localization:

• Improves trust
• Boosts conversion
• Reduces confusion
• Makes Account Editor feel native

Updated on: 25/06/2026