Languages & wording

This is the part that raises the most questions, so let’s take it slowly. No technical knowledge needed.

First: two things people mix up

	What it is	Who sees it
Admin language	The language this app is shown in while you work	Only you and your staff
Form wording	The words that appear in the form on your storefront	Your customers

They are independent. You can run the admin in English and sell in Spanish, or the other way round.

Admin language

Under Settings → Language you choose Automatic, English or Spanish.

It is saved in your browser and applied straight away, so there is no save button. Each person on your team can pick their own without affecting anyone else.

Form wording: where it comes from

Here is the important bit. Every text your customer sees can come from three different places, and when two of them disagree, one specific place wins.

Think of it as a ladder. Each rung overrides the one below:

4. Per-language translation (language selector)  ← always wins
3. What you type in the step's boxes             ← only if you change it
2. Your store's language (English, Spanish…)     ← the normal case
1. The factory wording, in English               ← the floor

1. Factory wording

The app ships with all its wording written in English. That is the floor: if nothing overrides it, that is what shows.

2. Your store’s language

The app comes translated. If your store is in Spanish, your customer sees the form in Spanish automatically — you don’t have to do anything.

This already covers most shops: you don’t need to touch anything below.

3. The text boxes inside each step

Each step has boxes where you can rewrite its labels: the titles for each eye, the field names, the error messages…

Here is the detail that surprises everyone:

Those boxes come pre-filled with the English factory wording. As long as you leave them as they are, the app treats them as untouched, ignores them, and your customer keeps seeing your store’s language.

Only when you type something different does your wording take over.

The example that confuses everyone

You open a prescription step and the box says SPH:. But you visit your Spanish storefront and the form says ESF:.

That is not a bug. SPH: is the factory wording, so the app ignores it and lets the Spanish translation through, which is ESF:.

Type Sphere: into that box and your customers will see Sphere:.

Watch out for one consequence: whatever you type there applies to every language in your store. Type Sphere: and a Spanish customer sees Sphere: too.

4. The language selector

If you sell in several languages and want different wording in each, use the language selector next to the Steps heading in the form editor.

Pick a language, write the wording for it, switch to another and write its own. Each language keeps its own set.

This overrides everything else, always.

How do I…

…rename a field across all languages Type the new wording into the step’s box. Good for single-language shops, or when you want the same term everywhere.

…use different wording per language Use the language selector in the editor. It is the only way to give each language its own.

…go back to the original wording Empty the box, or retype exactly the English text that was there. To the app both mean the same thing: untouched.

…keep a field in English inside a Spanish store The step boxes can’t do it: typing the original English text is indistinguishable from leaving it alone, so you’d get Spanish back. Use the language selector, pick Spanish, and type the English term you want there.

If you bring a form from another store

Every form has a base language: the language of the store where it was created. It’s the one the selector shows marked — Base.

When you import a form into a store whose primary language is different, the app switches the base to your store’s language and keeps the original language as one more translation. No text is lost and there’s nothing for you to do.

If some field had no translation into your language, it stays as it was instead of going blank: seeing the text in another language beats seeing nothing.

How to tell which language you’re editing

The selector next to the Steps heading always tells you which one is the base. If it says English — Base, whatever you type in the boxes is the English copy; for any other language, switch the selector first.

More detail in Copying a form to another store.

Wording that isn’t in the steps

The form’s general buttons — Next, Previous, Add to cart, Total, the error messages — ship translated with the app and follow your store’s language. Nothing to configure.

After changing wording, sync

Saving in the editor does not update your storefront yet. Press Sync now and wait for the status to read Synced. Until then your customers still see the previous version.