# Status Light Widgets

Clarity's status light widgets allow you to display tag states in a "panel light" style widget. This guide covers setting up the Enum Types that determine the colors and names of your status lights, and adding status lights to dashboards.

![](/files/-M1xhil66W7sCU8VK-iu)

### Add a Tag to a Dashboard

Navigate to the dashboard where you want to add a status light widget. Expand the Tags section in the sidebar, and find the tag you want to display in the status light widget. Drag the tag to the widgets panel at the top of your dashboard.

![](/files/-M1xQici2P8CTysXB5Hp)

![](/files/-M1xi_xSBDWT9CWXx2l7)

### Set Widget Type

Click on the widget you just added, and change the **Widget Type** from **Gauge** to **Status Light.**

![](/files/-M1xSUrFTtRT3FbvBiPN)

Use the **Status Light Style** section to choose a single light, horizontal multi-light, or vertical multi-light widget style. The **Labels** / **No Labels** option controls whether each light has a label identifying its value.

![](/files/-M1xSfz5O_zK4foAQxC4)

You'll see the gauge disappear, but you won't see lights for each possible value. You'll need to create an **Enum Type** to tell Clarity which colors and labels to assign to each possible value.

![](/files/-M1xTKcblwDj1eDTHTFu)

### Create an Enum Type

Click on the dashboard widget you just created, and click the **+** icon next to the **Enum Type** drop-down near the bottom of the form.

![](/files/-M1xVSYzrS78ZkoCm9n9)

Type in a name for your Enum Type. The Enum Type name should describe the type of thing you're displaying, e.g. "Pump State", not the name of the specific thing, e.g. "Pump 1".

![](/files/-M1xVPZv3MsgtKdE1P8-)

### Add Enum Values

Enum Values define the colors, names, and matching values for the lights in your widget.

Press the **+** button at the top of the Enum Values list to define a value:

![](/files/-M1xWbUJWlgFJApeQL3F)

Pick the light color you want to associate with this value:

![](/files/-M1xYhhAMzGoajAk1ZEK)

Enter the **Value** and **Display Text**.

* **Value**: Raw input value to match, e.g. "0" or "1"
* **Display Text**: What to show next to the light, e.g. "On" or "Off"

![](/files/-M1xZ-QKeyvV8-pUWMFV)

Add more options as needed:

![](/files/-M1x_0MS2Laq8FOgY10l)

Click "OK" to apply to your widget.

### Working Widget

Once you're done, you should see a widget that displays the colors and labels you configured.

![](/files/-M1x_hhrYDMglcJF6T2Q)

{% hint style="info" %}
If the tag you're displaying is unavailable, the lights will show a gray X pattern:
{% endhint %}

![Status light showing an offline tag](/files/-M1xa3tgcMfL7bxQn0L4)

### Add More Tags

Once you've configured an Enum Type, you can quickly assign more tags to that type. Find the additional tags you want to assign in the sidebar, and click on **Tag Settings.**

![](/files/FBW2ESdCEh55Cc2uswbz)

Select the desired **Enum Type**

![](/files/-M1xc9glPgw2sf-S8M4x)

![](/files/-M1xcHC0WEiF96SNCkDo)

{% hint style="info" %}
If you change the Color, Value, or Display Text fields for an Enum Type, you're affecting all tags assigned to that Enum Type. If you want a tag to act differently from other tags, create a new Enum Type and assign it to that tag.
{% endhint %}

Drag the newly configured tags to a dashboard to create more status light widgets.

![](/files/-M1xdzk1xGcL5zaHOtKK)


---

# 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.jcore.io/clarity/dashboards/status-light-widgets.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.