Translating themes

This page was printed on Apr 29, 2023. For the current version, visit https://help.shopify.com/en/manual/online-store/themes/customizing-themes/language/translate-theme.

Although Shopify themes are in English, some themes have more than one language option. These themes include translations of all of the text content in your online store, such as contact information and cart and checkout information.

For themes that include multiple languages, you can simplychange the theme language. If your theme doesn't have the language that you want, then you cancreate the translations yourself.

You can have one language active on your online store.

Choose a language for your theme

You can choose a language for your published theme. If the theme that you want to translate isn't published, then you need topublish your themebefore youchange the default language for your storeto update your theme language.

Create a translation for your theme

You cantranslate and localize your storeto change the language of your theme. You can add your own translations by installing Shopify'sTranslate & Adapt app, using CSV export/import, or by using a third-party app.

Types of content that can be translated

There are three basic types of content that you might want to translate:

You can translate each piece of text by entering translations into the text fields.

You don't have to translate every field in your theme. Your changes are saved automatically and you can stop at any time. You can access any existing translation if you want to make changes.

If you leave a field without a translation, then the default language for the theme is used.

You can translate plain text directly, but you'll need to take extra care when translating text blocks containing HTML or Liquid.

Translate plain text

For most of the text on your online store, you don't need to use HTML or Liquid. When you enter a translation of a plain text block, all you have to do is replace the text with its equivalent in the other language.

Text blocks that contain HTML

If a text block contains HTML, then you'll see pairs of angled brackets (<>) surrounding words or phrases.

It's important to understand how the HTML is being used in the block that you're translating. Although you'll need to leave most of the content in the original English, there might be some English words inside of the HTML tags that you'll want to translate.

Text blocks that contain HTML are typically used for the following reasons:

An HTML link is surrounded in tags that start withand end with.

You must translate only thenameof the link, and not its other components. The link name is the only part of the link that your customers will see.

Continue browsinghref="/collections/all">here.

In this example, you'd replace the wordsContinue,browsing, andhere, with a suitable translation.

没有翻译the destination address (also known as the target) in a link. The destination address is where a customer goes when they click the link. It's always shown in quotation marks and points to a specific web address. In the example link, the destination address is/collections/all.

Translate text styled with HTML

HTML is sometimes used to give emphasis or additional styling to words or phrases, or to display symbols. You must translate only the words that are being styled by the HTML, and not the codes or tags themselves. Take a look at theexamplesto make sure that you understand what to translate and what you should leave unchanged.

HTML styling examples

In the following example, thetags are used to display text in bold:

On Sale

In this case, you'd translate only the wordsOn Sale.

In the following example, HTML codes←and→are used to generate left and right arrow symbols:

←Previous Product
Next Product→

Here, you'd translate only the phrasesPrevious ProductandNext Product.

In the following example, HTMLtags are used to display the file namecollection-sidebar.liquidin bold.

Add a type to your products for this list to build itself. All lists are created incollection-sidebar.liquid

The file name here is aLiquid template file. You should translate the file name only if it's necessary to match the name of the file itself. For example, if you have created your own files, then you might need to change the file name in the HTML.

没有翻译HTML tags or symbol codes. These are used by your browser, and are not seen by your customers.

Text blocks that contain Liquid

没有翻译Liquidtags, objects, or filters.

Liquid is the templating language that controls the appearance of your website in different contexts. Liquid content is always wrapped in one of the following sets of symbols:

  • {{and}}
  • {%and%}
  • {%-and-%}

For example:

Posted on{{date}}

In this example, you would translate only the text around the Liquid, and not{{ date }}.

Here's an example of a text field that uses a combination of plain text, HTML, and Liquid:

{{ author }}on {{ date }}

Although this example might look complex, the only part that you'd need to translate is the wordon.

Ready to start selling with Shopify?

Try it free