For the complete documentation index, see llms.txt. This page is also available as Markdown.

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). 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

1

Add a language

Select Add translation and choose a language. It gets its own tab beside your default language.

2

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.

3

Save

Save the page. Nothing is live until you save.

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.

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

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 settings, in every language.

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.

Last updated