> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/shopify/shopify-native/configuration/languages-and-domains.md).
# Languages & Domains
{% hint style="danger" %}
#### **Managed Process**
* Languages and Domains configuration is implemented by ESW.
* Contact your ESW onboarding manager.
{% endhint %}
Use Shopify **Languages** to add storefront languages. Use **Markets** to assign languages and domains per region.
### Before you start
Adding a language does not translate your full store. Shopify auto-translates only supported theme and checkout content.
For everything else, upload translations or use a translation app. **Translate & Adapt** is the common default.
{% hint style="warning" %}
To manage **languages per market**, you need international domains configured (subfolders, domains, or subdomains). Without international domains, language settings apply across all active markets.
{% endhint %}
### Add a language to your store
{% stepper %}
{% step %}
### Open language settings
From your **Shopify Admin**, go to **Settings → Languages**.
{% endstep %}
{% step %}
### Add the language
1. Click **Add language**.
2. Select the language from the list.
{% endstep %}
{% step %}
### Choose where it applies
* If you have **one market** or **no international domains**, click **Add**.
* If you have **multiple markets** with international domains:
1. Click **Next**.
2. Select the markets to enable the language for.
3. Click **Done**.
{% endstep %}
{% step %}
### Add translations
* Import translations with **Translate & Adapt**, or another translation app.
* Confirm key storefront pages look correct before publishing.
{% endstep %}
{% endstepper %}
### Publish a language
{% stepper %}
{% step %}
### Open language settings
From your **Shopify Admin**, go to **Settings → Languages**.
{% endstep %}
{% step %}
### Publish
1. Under **Unpublished languages**, open **… (More actions)**.
2. Select **Publish**.
3. Click **Save**.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
If you publish without full translations, Shopify will prompt you. Untranslated content will stay in the default language.
{% endhint %}
### Assign languages and domains to a market
You must add the language to your store first. Then assign it to the market.
{% stepper %}
{% step %}
### Access Markets
From your **Shopify Admin**, go to **Settings → Markets**.
{% endstep %}
{% step %}
### Select the market
Open the market you want to configure.
{% endstep %}
{% step %}
### Open Languages and domains
Click **Languages and domains**.
{% endstep %}
{% step %}
### Add a language
1. Click **Add languages**.
2. Under **Not added to this market**, select the language.
{% endstep %}
{% step %}
### (Optional) Set domain and default language
Use the same **Languages and domains** screen to:
* Confirm the market domain setup.
* Choose the default language for the market.
{% endstep %}
{% endstepper %}
### Related topics
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developer.esw.com/shopify/shopify-native/configuration/languages-and-domains.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.