> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/translate-your-form.md).

# Translate your form

Translate a wholesale form's questions, pages and messages into your store's other languages, by hand or with AI.

Each form can show its questions in every language your store has. Buyers see the form in the language they are browsing your store in.

Translations work for forms from both the simple and the advanced builder.

## Before you start

Add your languages in Shopify: **Settings → Languages** (see [Shopify's guide](https://help.shopify.com/en/manual/markets/languages/managing-languages)). The app lists every language your store has, including languages you haven't published yet. You can translate those in advance; they show as **(not live)**.

If your store has one language, the page says so and there is nothing to translate yet.

## Open the translations

Save the form first. A new form, or one with unsaved changes, has nothing to translate yet.

* **Advanced builder:** **Settings** → **Translations** → **Edit**.
* **Simple builder:** **Translations** (the globe) at the top of the form.

The page is called **Translate** followed by your form's name.

## Translate the text

{% stepper %}
{% step %}

### Add a language

Select **Add translation** and choose a language. It gets its own tab beside your default language.
{% endstep %}

{% step %}

### Fill in the text

Type the translation under each string, or select **Translate with AI** to fill the whole language at once. Your default language shows as the source.
{% endstep %}

{% step %}

### Save

Save the page. Nothing is live until you save.
{% endstep %}
{% endstepper %}

To stop showing a language, open its tab and select **Remove** followed by the language name, then save.

### Translate with AI

**Translate with AI** translates every string in the language you are on. **It replaces what is already in that tab**, including text you typed yourself. Nothing is saved until you save, so read the result first and correct anything that sounds wrong.

You see **Translated** when it is done. **Partly translated** means some strings were left empty; type those in or try again.

## What you translate here

| Group                                                                                                    | Strings                                                                                                   |
| -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Form**                                                                                                 | **Form title**, **Description**, **No-access message**                                                    |
| One group per page: **Page:** and the page name (advanced builder), or the step's title (simple builder) | **Page title**, **Page description**                                                                      |
| One group per field                                                                                      | **Question**, **Placeholder**, **Help text**, **Consent text** or **Text**, and one **Choice** per option |
| **Stop messages** (advanced builder)                                                                     | The message shown by each stop rule                                                                       |

**Choice translations change only what the buyer reads.** The submission still records the option in your default language, so your rules, tags and the **Form Submissions** list stay the same whichever language the buyer used.

## What you translate in Customize

Buttons and messages that every wholesale form shares are not on this page. Translate them once, for all your forms, in **Customize** → **Wholesale form** → **Text & languages**. (The translations page calls this "Storefront → Wholesale form text".) See [The Customize page](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/show-final-prices-on/customize-page.md#text-and-languages).

| Group                  | Includes                                                                                                                   |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Buttons & messages** | The submit button, the success and error messages, **Back**, **Next**, the page counter, dropdown and country placeholders |
| **Refusals**           | What a buyer sees when submission limits or sign-in stop them                                                              |
| **Error messages**     | Field errors, such as a required field left empty                                                                          |

{% hint style="info" %}
**Text you set in Customize wins over the block.** If you set the submit button, success or error messages in **Customize**, they replace the same messages in the [Wholesale Form block](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/add-the-form-to-your-store.md#settings) settings, in every language.
{% endhint %}

{% hint style="warning" %}
In the advanced builder, the messages from **Submit rules** show in English in every language.
{% endhint %}

## Limits

* Up to 2000 characters per string.
* The `<` character isn't allowed.
* Keep anything in curly brackets, such as `{label}` or `{current}`, exactly as it is. The app swaps it for the real value. The editor warns you if one is missing.

## How the storefront picks the language

The form follows the language of the page the buyer is on. For French Canadian (`fr-CA`), the app uses a French Canadian translation, or a French (`fr`) one if there isn't one. For each string, the form shows:

1. the translation into the buyer's language;
2. otherwise, the text you set for your default language on this page;
3. otherwise, the form's own text.

To check, publish the language in Shopify, then open the form page with the language in the address, for example `/fr/pages/wholesale-application`.
