> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/options/option-elements/input-type-options/switch-button-element.md).

# Switch button element

The **Switch** element is a toggle-style input that allows customers to enable or disable a specific option. It's visually similar to a light switch or mobile setting toggle, offering a clean and user-friendly experience.

**🔧 Basic Settings:**

* **Label / Name**: Customize the title of the switch.
* **Required Field**: Make the switch mandatory before proceeding.
* **Add-on Product / Price**: Attach an additional product or cost if the switch is enabled.
* **Default Value**: Set the switch to ON or OFF by default.
* **Conditional Logic**: Use conditions to show or hide the switch based on other field values.

**⚙️ Advanced Settings:**

* **Suffix/Prefix**: Display additional text before or after the switch.
* **Help Text & Position**: Add helper text and choose its position (above, below, tooltip, etc.).
* **HTML Class**: Add custom styling if needed.
* **Column Width**: Adjust the width of the switch field to fit your layout.

**🧠 Use Case Examples:**

* Enable gift wrapping
* Add extended warranty
* Opt-in for personalized engraving
* Toggle special packaging or services

This element adds flexibility and improves the buying experience by allowing customers to make quick yes/no decisions with a simple click.

<figure><img src="/files/iUvBScmZ1tc3pQQAoYKD" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


---

# 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://docs.globo.io/options/option-elements/input-type-options/switch-button-element.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.
