> For the complete documentation index, see [llms.txt](https://nextsky.gitbook.io/purity-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextsky.gitbook.io/purity-theme/frequently-asked-questions/theme-translation.md).

# Theme translation

## 1. Single language

To translate your theme to another language, please follow these steps:

{% hint style="success" %}
**Step 1: Change your current Published languages**

Go to **Settings -> Languages -> Change default** to change your current Published languages

**Step 2: Update default theme content**

Go to **Online Store -> Themes -> Edit default theme content**

**Step 3: Translate the theme**

You can translate manually for each content. For example, I will translate the button Subscribe to French
{% endhint %}

## 2. Multi-language

Purity ships with translations for **32 languages**. Both the storefront (what your customers see) and the theme editor (the setting labels you see while customizing) are translated, so you can build your store in your own language.

When you add and publish one of these languages in **Settings -> Languages**, the theme's built-in text (buttons, labels, cart, search, and similar) appears in that language automatically. Any text you type yourself, such as headings and descriptions in sections, is translated separately (see Theme translation).

### Available languages

| Language              | Code    |
| --------------------- | ------- |
| English (default)     | `en`    |
| Arabic                | `ar`    |
| Bulgarian             | `bg-BG` |
| Chinese (Simplified)  | `zh-CN` |
| Chinese (Traditional) | `zh-TW` |
| Croatian              | `hr-HR` |
| Czech                 | `cs`    |
| Danish                | `da`    |
| Dutch                 | `nl`    |
| Finnish               | `fi`    |
| French                | `fr`    |
| German                | `de`    |
| Greek                 | `el`    |
| Hungarian             | `hu`    |
| Indonesian            | `id`    |
| Italian               | `it`    |
| Japanese              | `ja`    |
| Korean                | `ko`    |
| Lithuanian            | `lt-LT` |
| Norwegian (Bokmål)    | `nb`    |
| Polish                | `pl`    |
| Portuguese (Brazil)   | `pt-BR` |
| Portuguese (Portugal) | `pt-PT` |
| Romanian              | `ro-RO` |
| Russian               | `ru`    |
| Slovak                | `sk-SK` |
| Slovenian             | `sl-SI` |
| Spanish               | `es`    |
| Swedish               | `sv`    |
| Thai                  | `th`    |
| Turkish               | `tr`    |
| Vietnamese            | `vi`    |

{% hint style="info" %}
Don't see your language? You can still translate the theme manually or with the **Translate & Adapt** app by Shopify.
{% endhint %}

{% hint style="info" %}
To sell in multiple languages, you need to setup your store with some requirements below:

* [**Geolocation app**](https://apps.shopify.com/geolocation) by Shopify
* [**Translate & Adapt** ](https://apps.shopify.com/translate-and-adapt)app by Shopify
* A theme that's compatible with selling in multi-languages. (**Agile** theme is compatible with selling in multiple languages.)
  {% endhint %}

To translate your theme to Multi-language, please follow these steps:

{% hint style="success" %}
**Step 1: Install the Geolocation app and Translate & Adapt app by Shopify**

**Step 2: Add Market**

* Go to **Settings -> Market -> Add market** to add a new Market

**Step 3: Add Language**

* Go to **Settings -> Languages -> Add a language** to add a new language for your new market
* **Publish** this language

**Step 4: Back to Market and add new language to your new market**

* Go to **Settings -> Market**
* Click to **Manage -> Domain and languages** of your Primary market and tick to the new language you have just added.
* Save your configuration and click to Install **Translate & Adapt**

**Step 5: Auto translate theme with Translate & Adapt app**

* Open **Translate & Adapt** app, click to **Auto-translate**
* It might take about 10 minutes. After translating, back to your store and you can see the result
  {% endhint %}