Part 5. Finishing touches

20 The words your buyers read

The app speaks 33 buyer languages on its own. What it translates, what you write yourself, and the rules that differ from one page to the next.

Contents 20. Buyer wording

Two sets of words meet on the offer your buyer sees, and they behave differently.

What the app translates

Everything structural: the buttons, the price labels, the decline link, the confirmations, the error messages, on all four surfaces. All of it ships in 33 buyer languages and follows the language the buyer is actually browsing in. Portuguese and Chinese each come in two variants, for Brazil and Portugal, and simplified and traditional.

You do nothing. A French buyer gets a French button on the same offer that shows a German buyer a German one.

The app’s own admin, the screens you work in, exists in six languages: English, French, Spanish, German, Portuguese and Dutch. Those are two different lists and it is easy to mix them up: 33 for your buyers, 6 for you.

What you write

Your product names, your offer copy and your block texts are yours. The app never translates them, because guessing at your product wording is a good way to publish something embarrassing in a language you cannot check. If you sell across several languages, write in the language most of your buyers read, or keep it short enough that it works either way.

The Buyer page

The Buyer page in the app menu holds the structural wording you are allowed to change, in each language your store publishes. We prefill it with our wording, so you start from something that works.

The two one-click buttons, “Add to my order” and “No thanks”, cannot be changed: Shopify does not allow it on that page. They are still translated for each buyer.

The same page also carries a few settings that are not wording: the brand strip and progress steps from chapter 19, the frame around thank-you and order status blocks, the price setting and the email for unpaid orders from chapter 10.

The buyer wording page, showing the editable confirmation heading and subtext.
Structural words are handled for you. These are the ones that carry your voice.

One label stays in English. An item added from the thank-you or order status page carries a discount labelled "Thank you offer" on the order, in English, whatever the buyer's language.

Two rules for your text

Exclamation marks depend on the page. On the one-click page they are not allowed: Shopify’s guidelines for that page forbid them, and the app refuses to save one rather than letting it reach a reviewer. Your own texts in the checkout, on the thank-you page and on the order status page can carry them.

Say what happens. If accepting starts a subscription, if the item joins the existing order, if the price shown is a member price, write it. Every refund request in this category starts with a buyer who did not understand what one tap was going to do.

Last updated