App features
- Easy to set up, with no unnecessary features
- Easy to start at $4.99/mo
- Fully supports Japanese
- Simple, with nothing you don't need
- A clean, refined UI that doesn't get in the way of your design
- Add a paid or free option.
- Add extra fields: a selection (dropdown) or text.
This article explains how to translate the gift option text into each language, for customers abroad or stores that use more than one language. You can translate the block title, the gift's display name, field names, options and the input limit error message.
In this article
- How to add languages you can translate into (Shopify language settings)
- How to enter translations
- What is shown for text you don't translate
- What to check when translations don't appear
Where to go: Shopify admin → Apps → SAKU Gift Option → "Gift Option Settings" → "Translations" on the right
Overview
- Add the language you want to translate into under "Settings" → "Languages" in Shopify (1️⃣).
- In the app's "Translations", choose a language under "Language to translate" and click "Add" (2️⃣).
- Enter the translations in the fields for each language (3️⃣).
- Click "Save" in the save bar at the top of the screen (4️⃣).
What you need before you start
- SAKU Gift Option is installed
- The language you want to translate into has been added under "Settings" → "Languages" in Shopify (if not, add it in 1️⃣)
- To show it to customers, the language must be published in Shopify (you can prepare translations for unpublished languages in advance)
- With the "Use product information" method, translate the gift product's name with Translate & Adapt or a similar app
1️⃣ Add your store languages in Shopify
You can only translate into languages already added under "Settings" → "Languages" in Shopify. If you haven't added a language yet, go to "Settings" → "Languages" in your Shopify admin and add the languages you want. To show a language to customers, you also need to publish it in Shopify (you can prepare translations for unpublished languages in advance).
2️⃣ Add a language under "Translations"
Open "Gift Option Settings" and look at "Translations" below "Preview" on the right. It says "Translate the text shown to customers for each storefront language. Anything left blank shows the text set on the left."
The red box around "Translations" shows where you enter translations. For each gift option, the heading, display name, field names and options are listed.
In the "Language to translate" dropdown, choose a language (listed like "English (en)") and click "Add". Languages you've added are removed from the list. The store's main language is not listed, because the original text is shown as it is.
3️⃣ Enter translations for each language
A card for entering translations appears for each language you add (with the language name and a red "Delete" button). After the block title and the input limit error message, the fields are listed for each gift option: "Gift option 1", "Gift option 2" and so on (gift options you add on the Pro plan work the same way). It has these fields.
| Field | What it is |
|---|---|
| Block title | The heading of the gift option. If left empty, the standard text for each language is shown when the title is still the default ("Gift options"); if you changed the title in the theme editor, that text is shown. |
| Input limit error message | Up to 200 characters. If left empty, the message entered in the "Input limit error display" section on the same page (left side) is used. |
| Heading | The heading of the second and later gift options (shown on the page as "Heading:" followed by the original heading). It is shown only for gift options that have a heading, and is also used as the item name on the order. |
| Display name | The gift's name (shown on the page as "Display name:" followed by the gift's name). Shown only with the "Set in the app" method. |
| Field name | The name of an extra field (shown on the page as "Field name:" followed by the field's name). Shown for each extra field. |
| Options | The options (shown on the page as "Options:" followed by the field's name). Shown only for dropdown fields. Enter them separated by commas, in the same order as the original options. |
Example: if the original options are red, blue and gold in the store's main language, enter "Red, Blue, Gold" for English, in the same order. If the text you entered appears in that language's card, it has been entered correctly.
With the "Use product information" method, the gift display name field isn't shown. The translations of the Shopify product name and variant name are used instead, so translate the product information with Translate & Adapt (Shopify's translation app) or a similar app. The block title and extra fields can be translated on this page with either method.
Choose how the display name and price are set with "Set in the app" or "Use product information" in the red box.
Note: the gift's name at checkout and in orders: even with the "Set in the app" method, the gift is shown at checkout and in the order's line items with the product name of the product you registered. The display name you translate here is used for the choice in your store and for the "Gift option: display name" detail. To translate the product name at checkout in other languages too, translate the gift product's name with Translate & Adapt or a similar app.
If you change the original fields (for example, add options), review the translations too.
4️⃣ Save
Click "Save" in the save bar at the top of the screen. If there is so much translated text that it exceeds Shopify's storage limit (10,000 bytes), it can't be saved. In that case, reduce the fields or text and save again.
How it looks in your store
The translated text is shown in the customer's language. For example, if the customer's language is "ja-JP" (Japanese, Japan), the "ja-JP" translation is used first, and if there isn't one, the "ja" translation is used.
- Text you haven't translated is shown as set in the app (what you entered on the left).
- Fixed text such as "No thanks" and "Please select" switches automatically to Japanese, English, Simplified Chinese, Traditional Chinese or Korean. In other languages, it's shown in English.
- Messages that customers type are not translated. They are recorded in the order as entered.
Troubleshooting
-
The language I want isn't in "Language to translate"
Add the language under "Settings" → "Languages" in Shopify, then reload the app (click your browser's reload button, or press Ctrl+R on Windows or ⌘+R on Mac). Languages that already have a translation card are removed from the list. -
A yellow banner says "Could not load your store languages. Check that the app’s permissions are up to date, then reload this page. Your existing translations have been kept." and I can't choose a language
Check whether the app is asking you to update its permissions. After updating them, reload the page. Translations you've already entered are kept. -
Translations don't appear in the store
Check that (1) you entered the translations and clicked "Save", (2) the language is published in Shopify, and (3) the store is being viewed in that language. -
Option translations don't line up
Check that they are separated by commas in the same order and the same number as the original options.
