Liquify are official Shopify Experts & Partners since 2014. If you follow a link to Shopify from our website and make a subsequent purchase this may result in a commission at no extra cost to you. Our opinions remain our own.

Been waiting for multilingual functionality on Shopify?  Sick and tired of using rubbish apps which don’t actually work?  Shopify have finally announced the release of native multilingual functionality – a feature which has been sorely missed.

Shopify translations now allow merchants to deliver a fully localised experience to customers and creates more potential reach for your store. Luckily to aid this, Shopify has announced new APIs that enable Shopify merchants and developers to set up stores in multiple languages. The new APIs enabling Shopify multiple languages in stores include the following:

The Shop Locale API Update

This API helps manage locales and languages available on the merchant storefront. Shopify merchants can easily choose between different Shopify translations and enable and publish locales from the Shopify admin.

Merchants can choose between primary and alternate locales for their shop. For each locale, there are two attributes, primary and published. There can only be one primary locale, for all others, merchants can choose whether they are published or unpublished.

Every Shopify store can have up to 5 alternate published locales (and additional unpublished ones on top of that).

There are two locale formats that are accepted: with language subtag, or the language + region subtag (so either “en” or “en-UK”).

Note: Locales have to be enabled and published before it becomes available for translation.

The Shopify Translations API Update

The Shopify translations API enables consistent customer experience for international buyers. Having localised apps as part of the Shopify store localisation plays a big role in that customer experience.

Shopify developers can quickly check whether a merchant has a multi-language store by querying the ShopLocale object and retrieve a list of locales. If there’s more than one locale with published set to true, then the merchant does indeed offer localised Shopify storefronts.

The GraphQL Admin API helps create and retrieve translated content such as email notifications or product information. It also enables customers to view products in multiple languages and receive localised emails too!

The same API will create and retrieve content when the app requests for read_translations or write_translations access scopes. To be able to do that, the app needs permission from the user that will authorise it for access.

Some resource types that can be translated include:

  • Collections
  • Email and SMS templates
  • Links
  • Online store articles, blogs, pages, themes
  • Payment gateways and shipping rates
  • Price- and weight-based shipping rates
  • Shop and shop policies
  • Products and their options and variants

Developers will be able to retrieve a list of translatable resources, content, and their current translations with translatableResources queries for each. They can also use it to retrieve all translations for a locale at once.

To create translations, the GraphQL API will use mutations. The translationsRegister mutation is used to create new translations, and once created, the original content will have to be added to translatableContent field for the translation to work. To remove translations that are no longer in use or needed, the translationsRemove mutation will help remove them.

shopify multilingual functionalityThe Liquid API Update

The Liquid API needed some substantial changes in order for it to work well with the new Shopify translations and Locale APIs, and can now be used to create localised experiences directly from the Shopify admin.

All these new APIs updates are available in developer preview, and developers are free to visit the changelog to get a full list of what’s to come. The Unite developer preview also offers the exclusive ability to start selling in Shopify multiple languages immediately, so developers can build and modify apps right now to support multiple languages.

Downside of Shopify Multilingual

Our SEO was disappointed to not see the option for unique URL’s for each language.  Each handle will serve the same piece of content so you can’t have a German and an English URL – only one.  The impact of this will be felt in more competitive markets.

Need Help with a Shopify Multilingual Setup?

If you’re looking to take advantage of the new multilingual features from Shopify you’ve probably got a tonne of concerns and questions – any established retailer would.  It’s a feature we were excited to play with in beta and are just in the process of working with our first multilingual – single domain Shopify site right now.   So talk to us if this is functionality you would like to explore too.  Our Shopify Experts are here to help you scale into new markets with new languages.

Joe Dempsey

Joe Dempsey

Joe Dempsey is a Shopify Expert. With over 8 years of experience in eCommerce & Shopify he leads one of the most experienced Shopify Expert teams in the world. Founder of Liquify, he tends to work with large brands and Shopify Plus merchants who want to scale aggressively. He is a well known Shopify SEO expert & one of the most experienced Shopify developers in the world.