# Toggle

Toggle option set allows users to switch between 2 variants. There will be some cases where you will need this type of option set, such as hiding or showing things in your configurable product, but you can use this toggle for different non-visual options, which does not reflect a change in the 3D view.

In the below example, we will create a 'toggle' button to show or hide the available colors for chairs.

Adding a **Toggle** block is done the same way we add other types of option set. Go to the "Create Options" tab and click the drop-down button on the top right of the screen and select **Toggle**. After selection, click "**Add block**" to add it to the list of blocks in the configurator.

<figure><img src="/files/hmBgwKDQQvi3LccBAxwb" alt=""><figcaption><p>Add a Toggle option set</p></figcaption></figure>

Before adding Toggle to the blocklist, the platform will prompt you to define it by writing a **title** and add the first **variant**. You can also *hide* or *show* the title in the front configurator.

<figure><img src="/files/KEdbogDZwKvKgy0fF5G1" alt=""><figcaption><p>Define 'Toggle' option set</p></figcaption></figure>

After clicking "Add variant", a pop-up window will appear where you define your variant.&#x20;

<figure><img src="/files/SNRwivo01gNXA8Dt2zSX" alt=""><figcaption><p>Add a 'Toggle' variant</p></figcaption></figure>

In this variant we will say that the chairs are visible, therefore we call this variant "Show" in both **Title** and **Variant Name,** then we click "**Save**" located at the bottom right of the screen. We repeat this process by adding another variant within the Toggle option set, naming it "Hide".&#x20;

{% hint style="info" %}
**In this case, there’s no need to select a 3D model or material, as it will be restricted by the already added ‘Materials’ option set.**
{% endhint %}

<figure><img src="/files/e9R7Z74ZVaLTwBX5caNr" alt=""><figcaption><p>Add the second 'Toggle' variant</p></figcaption></figure>

Click the "**Save**" button and see both variants inside the Toggle button edit page.&#x20;

**NOTE:** You can add only 2 variants in one Toggle button.

<figure><img src="/files/DAnrkBB0YbPVEoNluNBJ" alt=""><figcaption><p>Edit Toggle Options</p></figcaption></figure>

Now click "Save" in the bottom right screen and you can see the toggle button in the block list.

<figure><img src="/files/UT5YxBPRgb60vQpzjQts" alt=""><figcaption><p>Toggle button in the block list</p></figcaption></figure>

Click "**Preview**" to see how it looks in your configurator.

<figure><img src="/files/lEHf1ugZ7RngLWhy43bm" alt=""><figcaption><p>Toggle button in Preview mode</p></figcaption></figure>

{% hint style="warning" %}
**As you click on the 'Toggle' button in 'Preview' mode, you will find that it does not hide the chair colors as you will need to add a restriction in the chair color options (Material) linked with the new Toggle button, in this case the 'Show' variant. This will be discussed in more detail in the** [**Restrictions**](/learning-the-app/products/create-options/restrictions.md) **chapter.**
{% endhint %}


---

# Agent Instructions: 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://docs.simplio3d.com/learning-the-app/products/create-options/toggle.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.
