# Switch

The "Switch" widget allows you to toggle one or more devices between two states.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FqGjEt4JuPPMUHDprjcWV%2F04CE2FAE-3CDD-4F28-91BB-EB4AE614825B.png?alt=media&#x26;token=03cb0e2a-fb7e-4394-83d3-dcae94afdbbe" alt=""><figcaption></figcaption></figure></div>

## When should this widget be used?

Switches should be used when you only want to toggle an asset between two states (e.g., "On" and "Off"). A common use case is for lights.

However, if you want to control dimmable lights, use the -> Light Control widget.

## Configure Widget

{% @supademo/embed url="<https://app.supademo.com/demo/KS_36muoBJWvH6P0wCVdI>" demoId="KS\_36muoBJWvH6P0wCVdI" fullWidth="true" %}

1. Make sure you are in the "Dashboard" menu
2. Click on "Add widget"
3. Click on "Input"
4. Click on "Switch"
5. Select the primary asset. The name of this asset will appear in the title bar of the widget.
6. Select the asset that you want to control via the switch.
7. (Optional) Give the asset a name
8. Select the setpoint
9. Select the current value
10. (Optional) Repeat the previous steps to create switches for other assets
11. Optional: Select how much space your new widget should occupy on the dashboard.
12. Click on "Add widget"

## Operate Widget

### Overview

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZKvaCPY0ggHsLhY1Yb9r%2F835BFCBA-60AF-4BF1-91A7-916FDABE925E.png?alt=media&#x26;token=d63c0e5c-9bc6-4af1-b8ca-cfcec2d416f0" alt=""><figcaption><p>The "Switch" widget in detail</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="81.33333333333331"></th><th width="239"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Widget Title</td><td>Title of the widget. Is influenced by the selection of the "Primary Asset."</td></tr><tr><td><strong>[B]</strong></td><td>Icon</td><td></td></tr><tr><td><strong>[C]</strong></td><td>Individual assets</td><td>The individual assets that were added to the widget</td></tr><tr><td><strong>[D]</strong></td><td>More options</td><td></td></tr><tr><td><strong>[E]</strong></td><td>Individual switches</td><td></td></tr></tbody></table>

### Operate Widget

Each individual asset **\[C]** that has been added is assigned its own switch **\[E]**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3emagpeGr97ZbY6sFjiP%2F98D43939-AC3D-414E-B546-1C9ECC35A7C5.png?alt=media&#x26;token=753cc585-ea87-429e-9cf9-85c0aab81e46" alt=""><figcaption><p>Left: Switch in "ON" state<br>Right: Switch in "OFF" state</p></figcaption></figure>

* Click on a switch that is in the "ON" state to set this switch to "OFF"
* Click on a switch that is in the "OFF" state to set this switch to "ON".