> 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**

![](/files/57048f253b81a06d469685b23041f06b26cceeea) ![](/files/4f2ba887d78f2254dfea80bd24463c88cb87b1c9)

#### 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.

![](/files/26a8c218a96836ae2f2a1ead9bd258e47f77e3f6) ![](/files/eaa7fd496dca57cc079461bbdbaea6ad6b3ca2fb)

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**

![](/files/8cfa5bf1b78b0081dd761d7c0e63163f7cfa0a93) ![](/files/4266700b3cd47cf7156c33d9abd3dbe655f3245f) ![](/files/d98de22df67abd4e8837c86b5082e7ce625553e7)

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.

![](/files/c5dfc00eeedc164315088c09a05248d466fbde23)

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

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

![](/files/17a9e1d12d618be250f2f2e09d22b99947cc4fb3)

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

![](/files/b39f0e6a35ed74c4c3b5cc1ab237e809182fd966)

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

**Translate the following content:**

* ***Box name***

  From:

  ![](/files/300855bcd812b914889d4ce7c35b0d44b548fd43)

  To:

  ![](/files/598f574de5f65f197ba0d1ab9383610fafcca396)
* ***Step name(s)***

  From:

  ![](/files/bf0a0e4fc76fdcaeade105e01a27a995d742b4f7)

  To:

  ![](/files/077907344fe221bf896b5ea318096991e478d720)
* ***Heading:***

  From:

  ![](/files/6cb0cbbc23312e66d55c1153718d6dd12441503f)

  To:

  ![](/files/410f45876e6ffa545ed145d7d814940c2056dc6b)
* ***Text***

  From:

  ![](/files/848374f9596e19921c9b17702f04a0fb48f70648)

  To:

  ![](/files/8edee82cbcb9d8acbc81c75c053731f726c9b21d)
* ***Discount messages (if applicable):*** including Progress and Success messages

  ![](/files/7d108093a855bee60468cd80744c62403c4003e0)
* ***Custom fields (if applicable):*** including option name, option label, option value labels, help text, tooltip, placeholder.

  From:

  ![](/files/c2802946fa83c04a15163adff126d34cdfd10ee5)

  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!


---

# 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:

```
GET https://easify.gitbook.io/easify-box-bundle-builder-docs/user-guide/visual-editor/advanced-feature/translate-box-specific-content.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
