> For the complete documentation index, see [llms.txt](https://easify.gitbook.io/easify-box-bundle-builder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easify.gitbook.io/easify-box-bundle-builder-docs/user-guide/visual-editor/advanced-feature/translate-box-specific-content.md).

# Translate Box Specific Content

If your Shopify store supports multiple languages, it’s important to ensure that your **box builder page content** is fully translated for every customer. While the [Shopify Translate & Adapt](https://apps.shopify.com/translate-and-adapt) app can help translate your store’s general content, it **cannot** cover all texts from the **Easify Box Builder** app, especially:

* **App default texts** (e.g. buttons, labels, validation messages...)
* **Your custom box content** (e.g. box name, step name, heading, text, progress messages...)

This guide will show you how to translate **box content**, which must be done **separately for each box** in the Visual Editor.

For instructions on translating **app default text**, [see this guide](/easify-box-bundle-builder-docs/user-guide/more-features/translate-app-default-texts.md) for detailed steps.

{% stepper %}
{% step %}

### Step 1: Prepare Store Languages

Before translating box content, make sure you’ve **added and enabled** the languages you want to support, and assigned them to your domain.

> ***If you’ve already done this when translating app default text, you can skip this step.***

To add languages to your store:

#### Option 1: From Shopify Admin

Go to **Shopify admin > Settings > Languages**

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FRN0Yzl3RjO3YB4wk1DCi%2Fsettings%201024x486.png?alt=media\&token=a2ac14e1-2c35-443e-ac30-5ce14dd2328b) ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2F1XnPHltuMh0ryyD6cV0b%2Flanguages%20menu%201024x523.png?alt=media\&token=a8750ee0-e26d-4ac9-89d2-54024e088d93)

#### Option 2: From Easify Box Builder app

In the app menu, click **Translations** > then click the **Add language** button. This will take you to your store’s language settings.

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FFiYmPa65MpwLb0TgRDNa%2Fadd%20language%201024x449.png?alt=media\&token=4b8a79a6-055b-4ddf-a9ef-cd58231cd2a6) ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FbtXoDUCl1e2uzBTP8pNi%2Flanguages%201%201024x417.png?alt=media\&token=5cf377c5-085b-4e44-8d56-95a2c7258f9e)

Once you're in the **Languages** page:

* Click **Add a language**
* Select the language you want to support
* In the popup, toggle the switch to assign the language to your domain
* Click **Done**

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FBGNg3J8oRAUtqljdvnWB%2Fimage%201024x448.png?alt=media\&token=131c8326-122e-491c-a94c-81ad858e5373) ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FHDdHNgPuUp0G7DJ5roeD%2Fimage%203%201024x351.png?alt=media\&token=da5768f9-8013-4c49-a500-8495837d6ed2) ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FJ1bV1GIYhCmaiF7FkCkZ%2Fassign%201024x351.png?alt=media\&token=e79b8b9f-296b-4e25-b9bc-c1518d5fd639)

Then, use the **Shopify Translate & Adapt** app or another translation tool to translate your **store content**, and **publish** the new language.
{% endstep %}

{% step %}

### Step 2: Translate Box Content in Visual Editor

Open the **Visual Editor** for the box you want to translate.

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2F6jT5p7shLaAoX6OFSml6%2Fimage%2073%201024x470.png?alt=media\&token=6d9945ae-cf4e-48bc-b9ce-a573ac18eab0)

All your original box content is set as **Default** – this is your base language.

In the **Visual Editor** menu (left side), click **Default** (Translation).

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2Fh436kXu9PuyqDIGIoTp2%2Fimage%2074%20588x1024.png?alt=media\&token=b2d77ec3-5e4c-4aee-b93f-2628520d9080)

From the dropdown, select the target language (e.g., German).

![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FDLjHh3PHxdfnXhQDRzdR%2Fimage%2075%20588x1024.png?alt=media\&token=a644d924-c902-4287-b627-5902f2c8695b)

The page will now be in the selected language’s view, ready for translation.

**Translate the following content:**

* ***Box name***

  From:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2Faoddl3ttSmL9wDEZVOsF%2Fimage%2076.png?alt=media\&token=26f67694-73c2-4f59-8807-a750b97a95a5)

  To:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FH3qWTVwXjXuyDUJuUYRp%2Fimage%2077.png?alt=media\&token=2e143d7e-bc97-48dc-bcec-db27cbcc72bb)
* ***Step name(s)***

  From:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2Fv4XJiyvRP5y2vMfWxXOB%2Fimage%2078.png?alt=media\&token=def98e05-8bc4-4257-941e-82003f230db1)

  To:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FLql80punRoo2c07s8dGv%2Fimage%2079.png?alt=media\&token=68ec2ad2-54f0-4680-9df9-d5418c73802f)
* ***Heading:***

  From:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FB2jJ8iomb1TjIErvK7Cf%2Fimage%2080%201024x340.png?alt=media\&token=532aa73a-78a8-4ac8-89e2-e9228a77fa3a)

  To:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2Fj10rztHJIEmBMi8Qr0M7%2Fimage%2081%201024x340.png?alt=media\&token=d6adf88a-5955-4e19-b7b2-cec5ec81916a)
* ***Text***

  From:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2F5Suw2NxsDBdvTa4auvbo%2Fimage%2082%201024x437.png?alt=media\&token=bdaff329-57eb-4b56-8714-a60152058ef6)

  To:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FsjSOwh0hI8ShL6dmlB3V%2Fimage%2083%201024x437.png?alt=media\&token=cfacf762-97d8-40e7-8a22-9bc4877b680b)
* ***Discount messages (if applicable):*** including Progress and Success messages

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2Frl4VKeUlGi07RxHN1euS%2Fimage%2072%201024x406.png?alt=media\&token=d1ceca42-9a7d-4a4e-a8c1-0eaf620a142d)
* ***Custom fields (if applicable):*** including option name, option label, option value labels, help text, tooltip, placeholder.

  From:

  ![](https://2136649288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMSHFLDPGBWSkDmxkdLpP%2Fuploads%2FacgSwmtbTOY9aJsJRhHZ%2Fimage%2084%201024x422.png?alt=media\&token=56f0f153-867e-4641-b40a-5af1ce41ffa4)

  To:

{% hint style="info" %}
Only translate **box-specific** content created in the Visual Editor.

Shared content across all boxes (e.g., buttons, search, sort, filter) is translated on the **Translations** page — see details in our [app default text guide](/easify-box-bundle-builder-docs/user-guide/more-features/translate-app-default-texts.md).

Product information (name, description, etc.) managed in Shopify should be translated directly in [**Shopify Translate & Adapt**](https://apps.shopify.com/translate-and-adapt), not in the Visual Editor.
{% endhint %}

Once your translation for the selected language is complete, **click Save**.

Repeat the process for any other languages you’ve added.
{% endstep %}
{% endstepper %}

### 💬 Need Help?

If you run into any issues or have questions, feel free to reach out via our **in-app 24/7 live chat**. We’re always here to help!