Shopify Multilingual Store: Languages and Markets

A Shopify store sells in several languages by adding languages in the admin, assigning them to markets, translating the content with Shopify's Translate & Adapt app (or CSV files, or a compatible third-party app), and publishing. Each published language gets its own URLs, and Shopify shows content in the default language wherever a translation is missing. Shopify's help pages change often, so confirm the details below on help.shopify.com before you rely on them.

How does a Shopify store handle multiple languages?

Shopify's help center describes the workflow in four parts: you add, publish and remove languages, you can change the default language, you choose which languages each market uses, and you translate the content. "Each published language gets its own URLs," and "when translations don't exist, your store displays content in your default language." The page lists three ways to translate: the Translate & Adapt app, importing CSV files, or a compatible third-party translation app from the Shopify App Store.

That structure has two consequences. First, a language is a publishing decision, not just a text swap: publishing makes new URLs public. Second, the default-language fallback means a half-translated language is still live and indexable, so translate before you publish, not afterwards.

How do Shopify Markets and languages fit together?

Markets are Shopify's way of grouping countries or regions you sell to, and languages are chosen per market. Shopify's help center says you can "choose the languages that each market uses," so one market can offer several languages while another offers one.

A practical way to plan:

Shopify's international SEO page says each market can use subfolders (for example yourstore.com/fr/), subdomains (fr.yourstore.com) or top-level domains (yourstore.fr). It describes subfolders as sharing domain authority with the primary domain and being the lowest setup effort, and recommends them for most stores; that is Shopify's own recommendation, not a neutral comparison. The wider trade-offs are in subdirectories vs subdomains vs ccTLDs.

What does Translate & Adapt translate?

Translate & Adapt is Shopify's own translation app. Shopify's help center says it is installed automatically when you add a new language, and that you can translate manually or automatically with AI translations from Shopify. The content it names includes products, collections, blog posts, policies and pages. In some countries the help page also describes an "Auto-sync" option to keep automatic translations up to date weekly.

Manual translation lets you control the exact wording and, according to the help page, customize content, images and logos for specific markets. Automatic translation is a fast first pass; whether it is good enough depends on your product and market, and for revenue-critical pages a human check is common practice. See machine vs human vs hybrid translation for how to decide.

The help pages we could retrieve do not state prices, quotas or the maximum number of languages. Treat those as unverified and check the app listing and current documentation.

What can developers do through the API?

For custom workflows, Shopify's developer documentation describes managing translations through the GraphQL Admin API. You query translatable resources, which return the original content with a digest, and register translations with the translationsRegister mutation, passing the digest to show which version of the source you translated. Some documented limits are worth knowing:

• You cannot change a store's primary locale through the API; it is done in the Shopify admin.
• A resource's tags field cannot be translated, and metafields can be translated only if they are publicly accessible.
• App proxies do not support translations.
• If a merchant changes a product's handle, URL redirects for that product are not supported for language-specific URLs.
• Market-specific theme content renders on the storefront only for shops whose plan includes market-specific theme customization.

The documentation also shows how to view a translation by adding the locale to the URL, for example myshopifystore.com/es/products/great-shirt. That shows the pattern: the language code is added, while the /products/ segment stays as it is.

How are language URLs created, and can handles be translated?

Publishing a language creates a separate URL for each translated page. With subfolders, the language appears as a prefix such as /fr/. Shopify's help center also says you can translate URL handles for each language in Translate & Adapt: automatic translation does not include handles, so you add a translated handle manually per language; a redirect is created from the default-language URL to the translated one; and sitemaps are updated to include translated handles.

Whether translated handles are worth the effort is an SEO decision, covered in Shopify multilingual SEO, along with hreflang and sitemaps.

What should I check in my theme?

The language selector and links are theme features, so confirm these before launch:

• Compatibility. Shopify's help pages list theme compatibility among the requirements for selling in multiple languages. Shopify's free themes are described as compatible, and third-party or custom themes need checking, so confirm with your theme developer and the current requirements page.
• Language selector. Your theme needs a way for visitors to choose a language, using real links. If it has none, Shopify's pages point to the App Store. The patterns are in language switcher UX best practices.
• Hard-coded links and text. Custom themes should build internal links with Shopify's routes object rather than fixed paths like /cart, otherwise links may drop the language prefix. Any hard-coded English in templates will appear in every language.
• Translatable theme text. Buttons, labels and section content need translating in the theme editor or Translate & Adapt, or they stay in the default language.
• Layout. Longer German or French text and right-to-left scripts can break fixed-width designs; see RTL languages web guide.

Does checkout appear in the customer's language?

Shopify's help center states that after you publish a language, checkout and email notifications are displayed in the customer's language, and that you can edit and preview email notification translations for each language, for example via Settings → Notifications. Verify the specifics by placing a test order in each language: confirmation emails, shipping notices and any app-generated messages are common gaps, because third-party apps may not support multiple languages by default and need checking with their developers.

Also decide how currencies, taxes and shipping messages behave per market; they are tied to Markets rather than to the language alone.

What are the common pitfalls?

• Publishing a language with untranslated product pages, which then show default-language text at a new URL.
• Forgetting translatable metafields, product options, collection descriptions, navigation menus and policies.
• Letting automatic redirection send visitors by location or browser language. Shopify's help center says automatic redirection applies to customers, with search engine crawlers excluded; Google separately advises against redirecting users based on guessed language because it can stop users and search engines reaching all versions. See auto-redirect by language or location.
• Changing a product handle later and breaking language-specific URLs, because the developer documentation says redirects are not supported for that case.

Key takeaways

• Languages are published per store and assigned per market; each published language gets its own URLs, and missing translations fall back to the default language.
• Translate & Adapt, CSV import and compatible third-party apps are the three documented translation routes.
• Language URLs depend on your market domain setup (subfolders, subdomains or domains); Shopify recommends subfolders for most stores.
• Check theme compatibility, the language selector, hard-coded text and test checkout in every language before launch.
• Verify plan requirements, quotas and prices on help.shopify.com; they change.

Sources

• Localization and translation – Shopify Help Center – adding and publishing languages, translation methods, URLs, fallback, checkout language
• Add language translations using the Translate & Adapt app – Shopify Help Center – translatable content, manual and automatic translation
• Translating URL handles in Translate & Adapt – Shopify Help Center – translated handles, redirects, sitemaps
• International SEO for markets – Shopify Help Center – subfolders, subdomains and domains per market
• Manage translated content – Shopify.dev – GraphQL translation workflow and documented limitations