> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brikl.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Switch 03

> A pill-shaped toggle switch with a circular white thumb that slides between off and on states.

<Frame>
  ![Switch 03](https://ffciaqoksnnzuihswbxs.supabase.co/storage/v1/object/public/components/Elements/Switchs/switch-big-circle.png)
</Frame>

## Overview

Switch 03 is a toggleable on/off switch component built with a Group container and a Shape element acting as the thumb. It manages its state using a custom boolean state called 'active\_', visually repositioning the thumb to the right when active and left when inactive. It is suitable for settings, preferences, or any binary input interaction.

## How to use

<Steps>
  <Step titleSize="h4" title="Open the Brikl panel">
    Navigate to the **Elements** category in the Brikl panel.
  </Step>

  <Step titleSize="h4" title="Copy the component">
    Find **Switch 03** and click **Copy**.
  </Step>

  <Step titleSize="h4" title="Paste into your editor">
    Paste it into your Bubble canvas with `Cmd + V` (Mac) or `Ctrl + V` (Windows),
    or right-click on the canvas and select **Paste**.
  </Step>
</Steps>

## States

This component includes conditional states that automatically change its appearance.

| State         | Trigger                                               | Visual effect                                                                                           |
| ------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Off (Default) | Initial load or when custom state 'active\_' is false | Switch background is light gray (rgba(216,211,212,1)) and the thumb is aligned to the left (flex-start) |
| On (Active)   | User clicks the switch when 'active\_' is false       | Switch background changes to dark (rgba(27,23,24,1)) and the thumb slides to the right (flex-end)       |

<Note>
  These states are handled natively by Bubble and require no additional setup.
  They will work automatically once the component is pasted into your editor.
</Note>

## Responsive

This component adapts to mobile screens. Font sizes and layout automatically adjust on screens smaller than Bubble's built-in mobile breakpoint.

## Workflows

This component includes pre-built workflows.

| Trigger                                          | Action                                                            |
| ------------------------------------------------ | ----------------------------------------------------------------- |
| Switch Group is clicked when 'active\_' is false | Sets the custom state 'active\_' to true, turning the switch on   |
| Switch Group is clicked when 'active\_' is true  | Sets the custom state 'active\_' to false, turning the switch off |

<Note>
  These workflows are included when you use the **Copy with Workflows** option in the Brikl panel.
</Note>

## Requirements

|             |                       |
| ----------- | --------------------- |
| License     | Starter plan required |
| Plugins     | None                  |
| Custom code | Not required          |

## Platforms

| Platform | Supported |
| -------- | --------- |
| Web      | ✅         |
| Mobile   | ✅         |

## License

<Note>
  This component requires a **Starter** plan.
</Note>