# Multilingual widget

### 1. Introduction:

Selling globally? The **Multilingual Widget** feature helps you connect with international shoppers by automatically displaying your subscription widget in the languages you choose. With just a few clicks, you can enable and publish multiple languages so your widget translations match your store’s audience - helping you build trust, improve clarity, and unlock more sales across different markets.

### 💡 What This Feature Does

* Lets you **select and publish** the languages you want your subscription widgets to appear in.
* Automatically translates all widget text into the chosen languages.
* Ensures shoppers see subscription options **in the same language as your storefront**.
* Helps you grow internationally with localization built right in.
* Integrates with [Shopify Translate & Adapt](https://apps.shopify.com/translate-and-adapt?search_id=a4b21ebc-29b3-4a4a-ad04-706f5a3706c0\&surface_detail=translate\&surface_inter_position=1\&surface_intra_position=5\&surface_type=search) to ensure synced languages across your store!

### 2. How to use:

{% stepper %}
{% step %}

#### Install Shopify Translate & Adapt

Please install [Shopify Translate & Adapt](https://apps.shopify.com/translate-and-adapt?search_id=a4b21ebc-29b3-4a4a-ad04-706f5a3706c0\&surface_detail=translate\&surface_inter_position=1\&surface_intra_position=5\&surface_type=search) first. This feature is integrated with this app!
{% endstep %}

{% step %}

#### Add languages

**Go to Settings → Languages** in your Shopify admin and check whether the available languages match your store’s needs. Add or edit languages as needed, and **make sure to Publish each language** before moving on.

<figure><img src="/files/fZabJXpS1cLydNgSL4QA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Start localizing

Open BOTH the **Subscription Plans** tab and the **Widget** tab in **TA Subscriptions App** to find the **Localize** button.

<figure><img src="/files/NpGmaU6bFYoFwithQWZw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4WwblNoYxnFElPS3XoFd" alt=""><figcaption></figcaption></figure>

> Note: The Localize button only appears when editing an existing plan or widget - create one first if you don’t see it.
> {% endstep %}

{% step %}

#### Auto-translate or translate manually

Click **Localize** to begin translating. You can translate manually or use **Auto-translate**. You may also switch the applied market at any time.

<figure><img src="/files/EkUyeqv4WMD6TdEquNHO" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### 📝 Notes

* Only **text values** can be translated - not variables. Variables are the elements that start with `_` or `{{ }}`. In this example, the translatable values are: **Subscribe and Save**, **Delivery every**, **Delivery every week 1**, **1 Week(s) 1**.
* When you update any content in the Widget, make sure to **re-localize the new content** in the Localization window. Otherwise, the updated text will not be translated.

### 🚀 Why Use Multilingual Widgets?

* **Boost conversions** by speaking your customers’ language.
* **Expand globally** without extra translation tools.
* **Improve user experience** with consistent, localized content.
* **Reduce confusion** and increase trust at checkout.

### 🌟 Tip

If you're targeting new international markets, enable multiple languages early to deliver a seamless experience from the first visit.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# 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://ta-subscriptions-app.easto.io/features/translation/multilingual-widget.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.
