# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avada.io/aov-post-purchase-upsell/advanced-settings/multi-language.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.