Plan: Essentials, Premium, Enterprise (Auto-translate is available on Premium and Enterprise)
Platform: All platforms
Applies to: Tracking pages, Returns pages, and Warranty pages (Warranty pages require AfterShip Warranty add-on)
Overview
Multi-language pages let you publish your Tracking, Returns, and Warranty pages in more than one language, so shoppers reach your page in their preferred language based on their locale.
Learn how to enable and customize page content in multiple languages using the AfterShip page editor. This guide walks you through setting your default language, adding languages, translating content, sharing images and URLs across languages, adding a language selector, and redirecting shoppers to the right language version. Once live, your page is more accessible to shoppers from different locales, which also raises the likelihood of additional sales.
Before You Begin
Requirements
A Tracking, Returns, or Warranty page created in your default language
Limitations
Warranty pages don't support the URL language parameter
In translation mode, you can edit content only, not the page design, so the layout stays consistent across languages
You can't delete the default language until you set another language as the default
Browser language detection requires at least one language besides the default
How Multi-Language Translation Works
Create your page in your default language. Once the page is ready, add languages and translate the content.
When you add a language, AfterShip creates a duplicate version of your page based on the default language.
You customize each language version in the editor (translation mode) or in the translation manager. You edit each translation against the real layout rather than in a spreadsheet.
Layout changes in the default language apply to all language versions, so the design stays consistent. This includes adding, removing, or reordering sections and blocks, adding widgets, adjusting styles, and turning on features such as shipment reviews, subscriptions, or the returns widget.
You need to translate any newly added sections or elements to match each target language.
You can translate content manually in the editor or translation manager, use the default translations AfterShip provides for its fixed interface wording, and auto-translate your own content.
Many fields stay in the default language until you translate them, so review each language version to make sure every field reads correctly.
Supported Languages
Page type | Languages | Supported languages |
Tracking pages | 36 | Arabic, Bulgarian, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Finnish, French, French (Canada), German, Greek, Hebrew, Hungarian, Indonesian, Italian, Japanese, Khmer, Korean, Norwegian Bokmål, Polish, Portuguese (Brazil), Portuguese (Portugal), Romanian, Russian, Slovak, Slovene, Spanish, Swedish, Tagalog, Thai, Turkish, Ukrainian, and Vietnamese |
Returns pages | 21 | Arabic, Chinese (Simplified), Chinese (Traditional), Czech, Danish, Dutch, English (US), French, French (Canada), German, Italian, Japanese, Korean, Norwegian (Bokmål), Polish, Portuguese (Brazil), Portuguese (Portugal), Slovak, Spanish, Swedish, and Turkish |
Warranty pages | 21 |
|
Step 1: Set Your Default Language
Your default language determines how translations are created and managed. AfterShip generates new languages as duplicates of the default language, and shoppers see the default language when their browser language isn't one you've added.
Go to Branded pages and open the page in the editor.
Open the language selector at the right of the top bar and click Manage languages.
Click the {⋯} menu of the language and click Set as default.
Go back to the editor and click Save.
The language selector in the editor top bar
Manage languages, with the more actions menu of a language open
Tip: Choose the language most of your shoppers use, and one your localization team can read.
Step 2: Add a New Language
Add each language you want to offer. The new language version keeps the same layout as your default language page.
Open the language selector at the top of the editor and click Manage languages.
Click Add language.
Select the language from the dropdown.
Click Add.
You add each language separately. Repeat these steps for more languages. After you add a language, translate the content and swap any images that contain text in the default language.
Note: Tick Auto-translate page content before you click Add if you want AfterShip to translate the existing content as the language is added. Review the result afterwards.
Step 3: Translate Content in the Editor
Translation mode lets you translate content directly on the page. The canvas renders in the language you selected, so you see exactly how each translation sits in the layout.
In the language selector, click Translate content next to the language. The editor enters translation mode for that language.
Check the bar under the top bar, which confirms you're in translation mode. From this bar, you can open Translate in list view(the translation manager) or click Exit translation mode to go back to editing the layout.
Select a section or block and translate its content: text, images, and links.
Click Save.
The editor in translation mode
In translation mode, you can edit content only, not the page design. For example, you can't enable a feature, add or remove a section or block, or change the layout. This keeps the layout consistent across languages. To change the design, exit translation mode and edit the default language.
Tip: Check button labels in each language. German and Finnish strings run long and can break a button designed around English.
Step 4: Translate Content in the Translation Manager
The translation manager lets you manage all translations in one place. It breaks the default language content down by page, then by section and block, and shows your source content and your translations side by side. For a Tracking page, the pages are Order lookup page, Tracking results page, Recipient page, Header and footer, and Widgets.
In the language selector, click Translate content next to the language.
Click Translate in list view on the translation mode bar.
Select the page from the dropdown, for example Order lookup page.
Select the section or block from the side panel, for example Tracking updates.
Translate the content row by row: click a field, type the translation, and repeat for each text.
Go back to the editor and click Save.
Repeat these steps for all pages and sections.
Translate in list view
Step 5: Auto-Translate Content
Auto-translate fills in the untranslated fields on the subpage you're viewing. This option is available on Tracking, Returns, and Warranty pages.
Open translation mode for the language.
Go to the subpage you want to translate.
Click Auto-translate in the translation mode bar.
Auto-translate doesn't overwrite content you've already entered manually for that language. The Auto-translate button turns gray once every field on the subpage is translated, so you can see at a glance whether anything is still outstanding. AfterShip translates fixed interface wording that isn't customizable for you.
Important: Auto-translate is a starting point, not a final answer. Review anything shoppers read at a decision point, such as return policy wording, refund and exchange options, and anything with legal weight.
Step 6: Apply Images and Destination URLs Across Languages
When you add or edit an image in the default language version, you can apply the image to other languages at the same time.
In the default language, select the section and the image block, then upload the image (or enter the destination URL and click Save).
When prompted to use this image (or URL) across languages, tick the checkbox.
Use the dropdown to select the languages to apply the image or URL to. The selected languages show together on the language bar.
Save your changes.
Step 7: Enable and Reorder the Language Selector
The language selector lets shoppers switch to their preferred language on the page.
In the Sections panel, select Header.
Turn on Show language selector.
To reorder languages, go to Manage languages and drag a language by its drag handle to the position you want.
The order in Manage languages is the order shoppers see in the language selector.
Note: The language selector appears only when the page has more than one language.
Step 8: Send Shoppers to a Language With a URL Parameter
Add a language parameter to the page URL to send visitors straight to that language version.
Add
?lang=followed by the language code to your page URL, using one of these formats:Universal URL:
https://{domain}/?lang=de, for examplehttps://yourstore.aftership.com/?lang=itorhttps://yourstore.aftership.com/?lang=zh-HansSpecific page URL (Tracking pages, which can have several pages):
https://{domain}/?page-name=brandname&lang=zh-Hans
In these examples, it and zh-Hans are language codes. If the URL has no language parameter, the page uses browser language detection (if enabled) or the default language.
Note: URL language parameters are available on Tracking and Returns pages. Warranty pages don't support the URL language parameter.
Step 9: Show the Page in the Shopper's Browser Language
When the URL has no language parameter, you can show the page in the visitor's browser language automatically. For example, if you've translated the page into Spanish and a visitor's browser is set to Spanish, the visitor sees the Spanish version without changing the language manually. If there's no Spanish version, the visitor lands on the default language and can still switch from the language selector.
In the language selector, click Manage languages.
Tick Show page language based on customer's browser language.
When this option is unticked, the page shows in your default language and visitors switch languages from the selector.
Before you enable this option, note that:
Redirecting visitors by browser language may stop them from seeing the other language versions of your page
The option is only available when you have at least one language besides the default
A visitor whose browser language you haven't added sees the default language version
Step 10: Review Each Language Before You Publish
Check every language version from the shopper's side before you publish.
Step through every subpage in each language, not only the first one.
Check the language selector on the shopper-facing page itself.
Check the page on mobile. Long translated strings wrap differently on a narrow screen.
Step 11: Delete a Language
Remove a language version you no longer want to offer.
In the language selector, click Manage languages.
Click the ⋯ menu of the language and click Delete.
You can't delete the default language. Set another language as the default first (see Step 1).
Warning: Deleting a language permanently removes all translations and changes made to that language version.
What Your Shoppers Will Experience
After completing these steps:
Shoppers switch to their preferred language from the language selector in the page header.
Shoppers who open a URL with a language parameter land on that language version.
Shoppers whose browser language matches a language you've added see that version, if you turned on browser language detection.
Shoppers whose language you haven't added see your default language version.
You manage every translation against the real page layout, in translation mode or the translation manager.
FAQs
1. Why aren't my return reasons or policy wording translated?
Much of the conditional wording on a Returns page comes from your return policy settings, not the page editor. This includes eligibility outcomes, return windows, return reasons, resolutions, and return instructions. Return reasons, workflows, refunds and exchanges, and return routing rules each have a Localize option that opens the multi-language editor. Plan for this when you add a language, because a Returns page has considerably more strings to review than a Tracking page of similar size.
2. Can I auto-translate my Tracking page?
Yes. Auto-translate is available on Tracking, Returns, and Warranty pages. Review the result before you publish.
3. Can I use a URL language parameter on my Warranty page?
No. URL language parameters are available on Tracking and Returns pages only.
4. Can I change the page design in translation mode?
No. Translation mode lets you edit content only. Exit translation mode and edit the default language to change the design.
5. Can I delete my default language?
No. Set another language as the default first, then delete the language.
6. What do shoppers see if I haven't added their language?
Shoppers see your default language version. They can still switch to another language from the language selector.
7. Why don't shoppers see the language selector on my page?
The language selector appears only when the page has more than one language and Show language selector is on in the Header section.
Key Takeaways
Tracking pages support 36 languages, and Returns and Warranty pages support 21, on all platforms
Your default language is the source: new versions duplicate it, and its layout changes apply to every version
Translate in translation mode or the translation manager, and share images and URLs across languages or per language
Shoppers switch languages from a reorderable selector or arrive through URL parameters or browser language detection
Many fields stay untranslated until you translate them, so review every version, including auto-translated content







