# Wix Multilingual: Using Multi-State Boxes to Switch From LTR to RTL

Source: https://support.wix.com/en/article/wix-multilingual-using-multi-state-boxes-to-switch-from-ltr-to-rtl (updated 2025-07-02)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

> **Warning:** Your site's SEO will be negatively impacted by adding multi-state boxes because search engine bots cannot read the boxes' content.

Some languages like English are written from left-to-right (LTR), while others like Hebrew are written from right-to-left (RTL). If your multilingual site supports both types, you can add [multi-state boxes](https://support.wix.com/en/article/velo-about-multi-state-boxes) that display different content based on the selected language. This allows you to create a different 'state' for each language and tailor the design individually.

![A screenshot from a live Wix site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/37145456-229a-4581-b781-486cfa8f772a/840cae25-b5fe-4456-a2a1-b0d4b1bdd3b0.gif)

---

## Step 1 | Add a multi-state box in your site's main language version

The first step is adding a blank multi-state box to your site in your main language. Design it for that language, adding text, images, buttons or any element you need.

**Wix Editor:**

> **Before you begin:** Make sure you've added [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) to your site and [enabled coding](https://dev.wix.com/docs/develop-websites/articles/getting-started/quick-start). 
>
>   
> ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/10/08/40cbcd76-fd2e-4825-95fb-312ba1662aa4/0611ccd6-7328-4b93-b41c-f76ec853322c.png)

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Click **Add** ![](https://d2eyqiy4n03ve6.cloudfront.net/12345678-1234-1234-1234-1234567890ab/2015/08/03/e486e9b2-0bf2-4a17-8fd7-4445d938d6c3.png) on the left side of your editor.
3. Click **Box**.
4. Click **Multi-State Boxes**.
5. Drag the **Blank** multi-state box to the relevant location on your page.

![A screenshot from a Wix site adding multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/18/1e52c6f8-5906-45d6-b7e1-30b05114b350/ca13c4e2-29d7-43cc-a55f-25bbf4971425.png)

1. Change your box's default ID to a meaningful name:  
   1. Click **Page Code** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/2a61531c-4d9f-4349-a05d-0fdd5f4b84fc/201846f8-36e4-4338-8bbf-c5f41088b4f8.png)on the left side of your editor.  
   2. Click **Home**.  
   3. Click the **Properties Panel** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/5642d040-0c6f-43b1-9bbd-68ac0ce2fab7/b43b9782-2a93-46b4-93bb-df166947e206.png) in the page code tab.  
   4. Select your multi-state box.  
   5. Enter a meaningful name for your box in the ID text box.

![A screenshot from a Wix site of multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/827f4a10-a8ce-4344-a2e6-a20088a56aa3/5a193b48-43e4-42d5-a1a7-c4d0201b2ec8.png)

1. Add elements to the box and design it as you wish.

**Studio Editor:**

> **Before you begin:** Make sure you've added [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) to your site and [enabled coding](https://dev.wix.com/docs/develop-websites/articles/getting-started/quick-start).

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/06/14/cef22a14-dfc9-43c7-a54f-72ed83266050/741248d2-4240-497e-a282-2a7d15d8afac.png) on the left side of your editor.
3. Click **Layout Tools**.
4. Click **Multi-state Boxes**.
5. Drag a multi-state box to the relevant location on your page.

![The Add Elements panel is open. The multi-state box element is highlighted.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2024/08/29/c9408a24-9aaa-4906-9370-8c559aa0f09a/4bb2ffea-2447-43d0-a00d-f0451fd44ec2.png)

1. Change your box's default ID to a meaningful name:  
   1. Click **Page Code** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/2a61531c-4d9f-4349-a05d-0fdd5f4b84fc/201846f8-36e4-4338-8bbf-c5f41088b4f8.png)on the left side of your editor.  
   2. Click **Home**.  
   3. Click the **Properties Panel** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/5642d040-0c6f-43b1-9bbd-68ac0ce2fab7/b43b9782-2a93-46b4-93bb-df166947e206.png) in the page code tab.  
   4. Select your multi-state box.  
   5. Enter a meaningful name for your box in the ID text box.

![A screenshot from a Wix site of multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/e074641a-181f-45a2-98c3-4d8fb7b4ed23/3804b83e-1f93-4b6a-9292-65f6ec8c131d.png)

1. Add elements to the box and design it as you wish.

---

## Step 2 | Change the current state's name

Once your box is ready in your main language, open the Manage States panel to rename the current state. Call it "LTR", in that exact spelling and capitalization (without the quotation marks), to ensure the code you'll add functions properly.

**Wix Editor:**

1. Select your multi-state box.
2. Click **Manage States**.
3. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to the current state's name.
4. Select **Edit ID**.
5. Type "LTR" in the text box and click **Done**.  
**Note:** If your primary language is RTL, name the state RTL instead.
6. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to other states and select **Delete** to remove them.

![A screenshot from a Wix site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/c683e897-36cc-4896-a8d1-a27a3cc00592/f6e35b89-1f50-4e3f-8583-ae6f17b6fc53.png)

**Studio Editor:**

1. Select your multi-state box.
2. Click **Manage States**.
3. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to the current state's name.
4. Select **Edit ID**.
5. Type "LTR" in the text box and click **Done**.  
**Note:** If your primary language is RTL, name the state RTL instead.
6. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to other states and select **Delete** to remove them.

![A screenshot from a Wix Studio site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/16/5c621aa1-373e-4169-a509-c8bc952d3ef0/ec6d2f0e-cc1f-464f-99eb-42b732c21741.png)

---

## Step 3 | Duplicate the state and rename it

After creating the "LTR" state in the Manage States panel, duplicate it and call the new one "RTL". Similarly to the first step, it's important that you call it "RTL", in that exact spelling and punctuation, so the code works as it should.

**Wix Editor:**

1. Select your multi-state box.
2. Click **Manage States**.
3. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to the current state's name.
4. Select **Duplicate**.
5. Click the **More Actions** icon![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) next to the duplicate state.
6. Select **Edit ID**.
7. Type "RTL" in the text box and click **Done**.  
**Note:** If your secondary language is LTR, change the state's name to LTR instead.

![A screenshot from a Wix site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/a4dc55d9-008e-4695-b81e-b5e0702b56df/df3ddceb-f829-46e4-9dd9-e95d87156e78.png)

**Studio Editor:**

1. Select your multi-state box.
2. Click **Manage States**.
3. Click **Duplicate State**.
4. Click the **More Actions** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/04/12/ac8d2ac1-bcf3-4152-bb10-eb11ecd81a64/e7894748-b97a-4868-bf03-44229db80ce2.png) icon next to the duplicate state.
5. Select **Edit ID**.
6. Type "RTL" in the text box and click **Done**.  
**Note:** If your secondary language is LTR, change the state's name to LTR instead.

![A screenshot from a Wix Studio site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/16/58332c2a-fd67-48cd-bd44-9a5a4ab77b53/cf97a4dc-0fe9-4c82-a33d-fb1d2eb38aa6.png)

---

## Step 4 | Adjust your box in the secondary language

Now, your multi-state box is set up and ready for translation. Switch to your RTL language, change the state to RTL and start localizing your content. You can reorganize the placement of the elements without affecting their placement in the original state. Then, copy the code snippet to your page's code.

**Wix Editor:**

1. Click the **Switch languages** drop-down menu at the top of the editor.

![A screenshot of clicking the Switch Languages drop-down at the top of the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/01/19/0eeca99a-547d-4dda-84a1-36cfe1170600/d8c4ef17-f83e-47af-904d-a4373668ca0a.png)

1. Select the RTL language you want to edit.
2. Click the multi-state box drop-down and select the relevant state of the box.

![A screenshot from a Wix site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/16/263656ba-75e5-4304-bca4-e78591056ecd/0231e46e-8dd6-44d4-9bfd-d028a69e017e.png)

1. Select the element in the box that you want to translate:  
   * **Text:** Click **Edit** **Translation** or **Auto-translate** to translate the text. Then, click the **Change text direction** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/10/28/c4277749-74fa-4657-b8ef-507b02ebe19e/c1523c7c-70a2-4815-8281-1c1108fc61bf.png) in the **Text Settings** panel to switch the text direction.  
   * **Images:** Click **Edit Translation**, then click **Change** to choose a different image for the RTL version of your site.

![A screenshot from a Wix site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/10/08/ea750584-a53f-4338-b2c4-2e147ccc61d8/7b444686-21a9-440e-85c4-4f39a03206a9.png)

1. Add the following code in the properties panel:  
   1. Click **Page Code** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/2a61531c-4d9f-4349-a05d-0fdd5f4b84fc/201846f8-36e4-4338-8bbf-c5f41088b4f8.png)on the left side of your editor.  
   2. Click **Home**.  
   3. Click the **Properties Panel** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/5642d040-0c6f-43b1-9bbd-68ac0ce2fab7/b43b9782-2a93-46b4-93bb-df166947e206.png) in the page code tab.  
   4. Select your multi-state box.  
   5. Copy the following code snippet below and paste it at the top of the coding panel.

```javascript
import wixWindow from 'wix-window';
const rtlLangs = ['he', 'ar', 'fa'];
```

1. Add the following code to your onReady function:

> **Important:**
>
> * Be sure to replace the placeholder IDs with the ID you created earlier.
> * The onReady function is written for your convenience, if you already have this function, add only the code within the first to last braces { }.

```javascript
$w.onReady(function () {
    let lang = wixWindow.multilingual.currentLanguage;

    if (rtlLangs.includes(lang)) {
        $w('#myBoxID').changeState('RTL');
    }
   else {
        $w('#myBoxID').changeState('LTR');
    }
});
```

![A screenshot of the Wix editor code panel](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/bd0baeb9-9296-4496-b8e2-0476b37b4b0e/5095266b-d363-4630-ae48-1aa13c100deb.png)

1. Click **Preview** to test your multi state box.
2. Publish your site when you are ready to make the changes go live.

**Studio Editor:**

1. Click the **Switch languages** drop-down menu at the top of the editor.

![A screenshot of the language panel in Wix Studio editor](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/03/755bb1bf-81f6-4c63-9751-74fd54a0fed7/63e5fd2d-d1b9-4771-8047-b84f244e159f.png)

1. Select the RTL language you want to edit.
2. Select your multi-state box.
3. Click **Edit Translation** and select **RTL**.

![A screenshot from a Wix Studio site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/16/68d9dee3-5568-42c8-a083-e76f828fd876/02367127-d0f1-407d-a205-bd749b9a8e8a.png)

1. Select the element in the box that you want to translate:  
   * **Text:** Click **Edit** **Translation** or **Auto-translate** to translate the text. Then, click the **Change text direction** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/10/28/c4277749-74fa-4657-b8ef-507b02ebe19e/c1523c7c-70a2-4815-8281-1c1108fc61bf.png) in the **Text Settings** panel to switch the text direction.  
   * **Images:** Click **Edit Translation**, then click **Change** to choose a different image for the RTL version of your site.

![A screenshot from a Wix Studio site using multi state boxes](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/16/b16042a3-5d84-46a0-80ae-c4767daea876/be75d8c3-a6e4-4f4d-a519-ba21cef633bb.png)

1. Add the following code in the properties panel:  
   1. Click **Code** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/01/09/02b00269-2e0b-4e7b-8029-f031139f2e3b/2bbb355c-4574-4525-837c-d9baec9a1751.png)on the left side of your editor.  
   2. Click **Start Coding**.  
   3. Click **Page Code**.  
   4. Click **Home**.  
   5. Click the **Properties Panel** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/11/20/5642d040-0c6f-43b1-9bbd-68ac0ce2fab7/b43b9782-2a93-46b4-93bb-df166947e206.png) in the page code tab.  
   6. Select your multi-state box.  
   7. Copy the following code snippet below and paste it in the coding panel.

```javascript
import wixWindow from 'wix-window';
const rtlLangs = ['he', 'ar', 'fa'];
```

1. Add the following code to your onReady function:

> **Important:**
>
> * Be sure to replace the placeholder IDs with the ID you created earlier.
> * The onReady function is written for your convenience, if you already have this function, add only the code within the first to last braces { }.

```javascript
$w.onReady(function () {
    let lang = wixWindow.multilingual.currentLanguage;

    if (rtlLangs.includes(lang)) {
        $w('#myBoxID').changeState('RTL');
    }
   else {
        $w('#myBoxID').changeState('LTR');
    }
});
```

![A screenshot of the Wix Studio editor code panel in the editor](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/50f70a50-058e-44ed-a4da-8b9312f94060/2024/12/19/c9500345-1679-44cd-bf3f-d01e5b2775f2/bcc73b2a-db8f-4a5a-a17b-5ee58041199a.png)

1. Click **Preview** to test your multi state box.
2. Publish your site when you are ready to make the changes go live.

> **Would you like to see additional RTL capabilities?** With Wix Multilingual, you can create a multilingual site with right-to-left content. Currently, you can [customize some aspects of your site like the menu, text, and images to be RTL per language](https://support.wix.com/en/article/wix-multilingual-creating-a-multilingual-site-with-right-to-left-content) (e.g., Hebrew, Arabic).
>
>   
>  What additional RTL capabilities would you like to see in Wix Multilingual? [Contact Customer Care with your feedback and suggestions](https://www.wix.com/contact).
