# Multi-language Support

Translate your upsell offers into multiple languages to match your store's locales. The app detects the customer's language and shows the translated version automatically.

{% embed url="<https://d2798l25hiaz3h.cloudfront.net/uzteDnftjvd3.webp>" %}

## How it works

1. The app reads your Shopify store's published languages
2. You translate offer content for each language
3. When a customer views an offer, the app shows the translation matching their browser/store locale
4. If no translation exists, the default language is shown

## What can be translated

### Offer-level content

| Element              | Description                          |
| -------------------- | ------------------------------------ |
| Offer title (header) | The main headline of your offer      |
| Countdown timer text | The urgency message above the timer  |
| Free shipping text   | Free shipping badge label            |
| Coupon title         | Main coupon text (TKU coupon offers) |
| Coupon subtitle      | Secondary coupon text                |

### Widget-level content

| Element                  | Description                          |
| ------------------------ | ------------------------------------ |
| Variant picker label     | Label for variant selection dropdown |
| Quantity selector label  | Label for quantity input             |
| Compare discount text    | "You save X%" text                   |
| Note text                | Additional info/note content         |
| Accept button text       | CTA button text                      |
| Decline button text      | Skip/decline button text             |
| Per-product decline text | Individual product decline text      |

### Price breakdown labels

| Element                   | Default text     |
| ------------------------- | ---------------- |
| Subtotal                  | Subtotal         |
| Discount                  | Discount         |
| Shipping                  | Shipping         |
| Applied discount          | Applied discount |
| Free                      | Free             |
| Tax                       | Tax              |
| Total                     | Total            |
| Show/Hide price breakdown | Show / Hide      |

### Testimonial widget

| Element        | Description           |
| -------------- | --------------------- |
| View more text | "View more" link text |
| View less text | "View less" link text |

### Subscription labels (if using selling plans)

| Element                 | Description                        |
| ----------------------- | ---------------------------------- |
| Accept terms text       | Subscription terms acceptance      |
| Recurring subtotal text | Recurring payment label            |
| Selling plan help text  | Help text for subscription options |
| One-time purchase label | One-time purchase option label     |
| Subscription label      | Subscription option label          |

### Claim Confirmation labels

| Element                        | Default text                              |
| ------------------------------ | ----------------------------------------- |
| Confirmation message           | "You've accepted the deal!"               |
| Description                    | "Your order has been updated – see below" |
| Original order text            | "Original order"                          |
| Subtotal, Shipping, Tax labels | Standard labels                           |
| Item text                      | "item(s)"                                 |
| Show/Hide text                 | "Show" / "Hide"                           |

## Setting up translations

### Step 1: Ensure languages are published in Shopify

Go to **Shopify Admin → Settings → Languages** and make sure your target languages are published.

### Step 2: Open translation settings

In the app, go to your offer's **Settings** or the **Translation** section. You'll see a list of your store's published languages.

### Step 3: Activate a language

Toggle the language to active. This opens the translation editor for that language.

### Step 4: Translate content

Fill in translations for each translatable element. You'll see the default text alongside the translation field for easy reference.

### Step 5: Save

Save your translations. They'll be applied immediately to customers browsing in that language.

## AI-powered translation

For paid plans, **AI-powered translation** is available. This feature automatically translates all offer content into your target language with one click.

To use AI translation:

1. Open the translation editor for a language
2. Click **Auto-translate**
3. Review the generated translations
4. Adjust any translations as needed
5. Save

> **Note:** AI translation provides a starting point. We recommend reviewing translations for accuracy, especially for marketing copy and brand-specific terminology.

## Tips

* Always review AI translations for brand voice consistency
* Test translated offers by switching your browser language
* Remember to translate both offer-level AND widget-level content for a fully localized experience
* Claim confirmation labels should also be translated if you use the claim confirmation feature