> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/translation/multilingual-widget.md).

# Multilingual widget

Translate plan names, purchase options, and widget text on your product pages with Shopify Translate & Adapt.

The subscription widget on your product pages shows two kinds of text:

* **Selling plan text**: the selling plan name, the purchase option label, and the name and description of each plan option.
* **Widget text**: titles and labels you set in the widget editor, such as "Subscribe and save" or "Delivery every".

You translate both with **Shopify Translate & Adapt**. The app opens it for you with the **Localize** button.

## Before you start

* Add and **publish** your languages in **Shopify admin > Settings > Languages**.
* Install **Shopify Translate & Adapt**.

## Translate a selling plan

{% stepper %}
{% step %}

### Open Localize

In the app menu, click **Selling Plans** and open the selling plan. In the **Preview** card, click the **Localize** icon. Translate & Adapt opens in a new tab.

**Localize** works only after the selling plan is saved. Save your changes first.

![The Localize icon in the Preview card of a selling plan](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FDi0eY9W1Nwps6Opl3c9a%2Fselling-plan-localize.png?alt=media)
{% endstep %}

{% step %}

### Choose the language

At the top of Translate & Adapt, choose the language you want to translate into.
{% endstep %}

{% step %}

### Translate the Translations field

The **Translations** field lists the text of the selling plan, one item per line, for example `{{name}} = Prepaid and save`.

![The Translations field of a selling plan in Translate & Adapt](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FB7ZaZWnd6vcD6SMi3aWA%2Ftranslate-adapt-plan.png?alt=media)

Copy **all** the lines into the box for your language, then translate only the text after `=`:

```
{{name}} = Prepagado y ahorra
{{options}} = Frecuencia de entrega y facturación
{{sellingPlans.0.name}} = Entrega cada mes; facturado cada 3 meses
{{sellingPlans.0.options}} = 3 meses
{{sellingPlans.0.description}} = $69.60 en lugar de $87.00
{{sellingPlans.0.gid}} = 32322584796
```

{% hint style="warning" %}

* Don't change the part before `=`.
* Keep the `gid` lines exactly as they are. The app uses them to match each translation to its plan option.
* Keep every line. A missing line shows as empty text on the widget.
  {% endhint %}
  {% endstep %}

{% step %}

### Save

Click **Save** in Translate & Adapt. Open a product page in that language to check the widget.
{% endstep %}
{% endstepper %}

## Translate a widget

{% stepper %}
{% step %}

### Open Localize

In the app menu, click **Widgets** and open the widget. In the top bar of the editor, click **Localize**. Translate & Adapt opens in a new tab.

**Localize** is available only when the widget is **Active** and published. Special templates don't have **Localize**.

![The Localize button in the widget editor](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FcKlBqkXuZK5WlxpLLPYa%2Fwidget-localize.png?alt=media)
{% endstep %}

{% step %}

### Translate and save

Choose the language, translate the text after `=` on each line, and keep the part before `=`. Click **Save**.
{% endstep %}
{% endstepper %}

Only these texts of a widget can be translated: titles, labels, plan option labels and content, benefit badge labels, descriptions, and content blocks. Other text, such as free gift text or the price per delivery, stays in the language you typed in the editor.

## Good to know

* Only text can be translated, not variables. Variables start with `_` or are written as `{{ }}`, for example `{{save_value}}`. Keep them as they are.
* When you change a selling plan or a widget, click **Localize** again and translate the new text. Translate & Adapt marks changed text as outdated.
* Customers see the language they choose on your store. Text you haven't translated is shown in the original language.

*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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/translation/multilingual-widget.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
