Skip to content

Translation Overrides

Overview

Translation Overrides allows you to customize any text label in your store without modifying the core translation files. Override specific words, phrases, or sentences to match your brand voice or local terminology.

Accessing Translation Overrides

Navigate to: System Settings > Translation Overrides from the sidebar menu

Translation Overrides List

Why Use Translation Overrides?

Customization Without Code Changes

  • Change "Add to Cart" to "Buy Now"
  • Replace "Products" with "Items" or "Inventory"
  • Localize currency terms or business terminology
  • Fix awkward translations in your language

Brand Voice

  • Match your unique brand terminology
  • Use industry-specific language
  • Create a consistent customer experience

Multi-Tenant Flexibility

  • Each store can have its own terminology
  • Override translations without affecting other tenants
  • Maintain core updates while keeping customizations

Translation Overrides List

List Columns

Column Description
Locale Language code (en, ar, etc.) shown as badge
Translation Key Original key being overridden
Override Value Your custom replacement text
Updated At Last modification date

Filtering

Filter by locale to see overrides for a specific language.

Sorting

Default sort is by updated date (newest first).

Creating a Translation Override

Click "New Translation Override" to create an override.

Create Translation Override

Step 1: Select Locale

Choose the language for this override:

  • English - Override English text
  • Arabic - Override Arabic text
  • Turkish - Override Turkish text
  • (Other configured languages)

Important: Each override applies to ONE language only. Create separate overrides for each language if needed.

Step 2: Select Translation Key

Choose which text to override from the searchable dropdown:

  • Search: Type to find specific text
  • Preview: Shows current translation value
  • Format: Keys are typically the English phrase or a dot-notation key

Examples of Translation Keys:

Key Original Value
Add to Cart Add to Cart
Products Products
Order Placed Successfully Order Placed Successfully
Continue Shopping Continue Shopping
Your cart is empty Your cart is empty

Step 3: View Original Value

After selecting a key, the Original Value field shows the current text:

Original Value: Add to Cart

This helps you understand what you're replacing.

Step 4: Enter Override Value

Type your custom replacement text in the Override Value field:

  • Type: Multi-line text area
  • Rows: 3 lines
  • Required: Yes

Example:

Original: Add to Cart
Override: Buy Now

Step 5: Save

Click Save to apply the override immediately.

Override Examples

E-commerce Terminology

Locale Key Original Override
en Products Products Items
en Add to Cart Add to Cart Add to Bag
en Shopping Cart Shopping Cart Shopping Bag
en Checkout Checkout Complete Purchase

Industry-Specific

Locale Key Original Override
en Products Products Equipment
en Categories Categories Departments
en Orders Orders Reservations
en Add to Cart Add to Cart Book Now

Arabic Improvements

Locale Key Original Override
ar Products منتجات البضائع
ar Add to Cart أضف إلى السلة اشتري الآن
ar Checkout الدفع إتمام الشراء

Brand Voice

Locale Key Original Override
en Welcome Welcome Hey there!
en Thank you for your purchase Thank you for your purchase You're awesome! Thanks for shopping with us
en Order Confirmed Order Confirmed You Did It!

Managing Overrides

Editing

Click Edit on any override to modify:

  • Locale cannot be changed (delete and recreate if needed)
  • Key cannot be changed (delete and recreate if needed)
  • Update the Override Value as needed

Deleting

Click Delete to remove an override. The original translation will be restored immediately.

Bulk Actions

Select multiple overrides to delete them in bulk.

Best Practices

Be Consistent

If you change "Cart" to "Bag", update all related terms:

  • Shopping Cart → Shopping Bag
  • Add to Cart → Add to Bag
  • Cart is empty → Bag is empty

Test Your Changes

After creating overrides:

  1. Visit your storefront
  2. Check all affected pages
  3. Test in all languages you've overridden
  4. Verify mobile app if applicable

Document Your Overrides

Keep track of what you've changed and why. This helps when:

  • Training new staff
  • Troubleshooting issues
  • Maintaining consistency

Consider All Languages

If you override a term in English, consider whether the same change is needed in other languages.

Technical Notes

Override Priority

Translation overrides have the highest priority:

  1. Override (if exists) → Used first
  2. Tenant-specific translation → Used if no override
  3. Default translation → Used as fallback

Cache

Overrides may be cached for performance. Changes should appear immediately, but in rare cases, clearing the cache may be needed.

Placeholders

Some translations contain placeholders like :count or :name. Preserve these in your overrides:

Original:

You have :count items in your cart

Override:

Your bag contains :count items

The :count placeholder will be replaced with the actual number.

Troubleshooting

Override Not Appearing

  1. Clear browser cache
  2. Check you selected the correct locale
  3. Verify the key matches exactly
  4. Check if there's a more specific key

Wrong Original Value

If the original value doesn't match what you see on the site:

  • There may be multiple keys for similar text
  • Try searching for the exact text you see
  • Check both the key name and original value

Saving Changes

Click Save when creating or editing an override. Changes take effect immediately.