# 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".


---

# 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.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/switch.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.