# Studio Editor: Using Multi-State Boxes

Source: https://support.wix.com/en/article/studio-editor-using-multi-state-boxes (updated 2026-10-05)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Multi-state boxes let you show different content for different situations in the same container box, displaying one state at a time. Choose the amount of states your box should have, design them completely and give them IDs that you will later use in your code.

Your code defines when each state should be displayed. You can create conditions for each state to appear automatically, or let visitors navigate on their own.

![A GIF showing a multi-state box on a live state changing states.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/07/15/64b53448-3219-4e1d-9cc7-d54c4f331402/9082672e-71ee-49b7-9a17-7957486083cb.gif)

---

## Step 1 | Add a multi-state box

The first step is adding a multi-state box to your site directly from the Add panel. Drag the box to the desired location on your page.

### To add a multi-state box:

1. 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 the Editor.
2. Click **Layout Tools**.
3. Click **Multi-state Boxes**.
4. 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)

> **Use multi-state boxes inside repeaters:** Once you add a multi-state box to a [repeater](https://support.wix.com/en/article/studio-editor-adding-and-customizing-repeaters) item, it's automatically added to the rest of the items with the exact same design. This is useful for lists with repeating items like FAQs or product galleries.

---

## Step 2 | Add and design the states

Once you've added the box, design the states that it displays. You can customize these states however you choose: Use them for small badges like product availability (e.g., "New", "Out of Stock"), or create a completely different design for each state.

Click below to learn how to:

**Select and design a state**

The states that you create are the [child elements](https://support.wix.com/en/article/studio-editor-working-with-layers) of the multi-state box. You can see and customize each one individually directly from the Manage States panel.

  
**To select and design a state:** 

1. Select the multi-state box.
2. Click **Manage States**.
3. Click a state in the list.
4. Add elements and design the state as you wish.

  
**Tip:** While designing the states, code is not required. This means everyone can customize them – not just developers.

**Add a state**

You can add as many states as you need to your multi-state box.

  
**To add a new state:** 

1. Select the multi-state box.
2. Click **Manage States**.
3. Click **Add New State**.
4. Add an ID for the state:  
   1. Hover over the new state and 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).  
   2. Click **Edit ID**.  
   3. Enter a new ID for this state.  
   4. Click **Done**.

**Rename a state**

Enter a unique ID for each of your states. While writing the code that defines when the states appear, this is the IDs you'll need to use.

  
**To rename a state:** 

1. Select the 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. Click **Edit ID**.
5. Enter the new ID in the text box and click **Done**.

**Remove a state**

1. Select the 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. Click **Delete**.

**Reorder states**

For your convenience, you can move states in the Manage States panel by dragging and dropping them.

  
1. Select the multi-state box.
2. Click **Manage States**.
3. Click and drag the **Reorder** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2022/05/10/7805b865-87d0-49f1-9a47-d8c0c8cf23e4/7fe18125-aa27-4584-9f93-f9a933757428.png) up or down to change the order of the states.

![The Manage States element of a multi-state box is open in the Studio Editor, showing the options.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9432a2ad-f01d-4a3d-ae53-370c37e15e62/2023/10/04/9232004c-4e0f-4da3-ba88-158436f54a1f/fdaf0b38-92d4-4507-8876-1dfa20a48ff8.png)

> **Design tip:** The states can have different height properties, which allow you to reveal additional info for example. However, the width of your states always stays the same.

---

## Step 3 | Add code

The last step to make the multi-state box functional is adding code that controls when each state appears.

Using the functions and events available in the [Velo API](https://www.wix.com/velo/reference/$w.MultiStateBox.html) for multi-state boxes, you can define and implement rules for displaying and navigating your states.

> **Important:** While adding the relevant code, make sure you wrote the state IDs correctly, with the exact same spelling and capitalization.

![A GIF showing the states of a multi-state box, and their relevant codes to the left.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2021/07/15/7eddef13-d3eb-4282-9c66-d64f83c458fb/ef0b942b-69e0-4426-a5f1-6f446e6c27cf.gif)

> **Next:** Learn more about [working with your multi-state box and code](https://support.wix.com/en/article/velo-tutorial-working-with-multi-state-boxes-and-code).
