# Switch

The "Switch" widget allows one or more devices to be switched between two states.

<div data-full-width="true"><figure><img src="/files/d8c12843ac5698a098c9f76aded26eadde7fc48d" alt=""><figcaption></figcaption></figure></div>

## When should this widget be used?

Switches should be used when you want to switch an asset exclusively between two states (e.g. "On" and "Off"). A common use case is lamps.&#x20;

However, if you want to control dimmable lamps, use the widget -> Lamp control.&#x20;

## Configure Widget

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

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

## Operate widget

### Overview

<div data-full-width="true"><figure><img src="/files/0877474a1eb74796f78c4c6d29529bab31161761" alt=""><figcaption><p>The "Switch" widget in detail</p></figcaption></figure></div>

<table><thead><tr><th width="81.33333333333331"></th><th width="275"></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

For each individual asset added **\[C]** is its own switch **\[E]** assigned.

<figure><img src="/files/1b2fe585569686148e521dc62fe3b0e7d68e692e" alt=""><figcaption><p>Left: switch in "ON" state<br>Right: switch in "OFF" state</p></figcaption></figure>

* Click a switch that is in the "ON" state to set it to "OFF"
* Click a switch that is in the "OFF" state to set it 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/english-v14/documentation/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.