> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/english-v14/documentation/widgets/predefined-widgets/alarm.md).

# Alarm

Using the "Alarm" widget, you can monitor a single asset for alarms.

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

<figure><img src="/files/26795fb13430ef59c422cec30fc60256ace935d8" alt=""><figcaption><p>A dashboard with 4 alarm widgets.<br>From left to right: high priority, medium priority, low priority, no alarm present.</p></figcaption></figure>

## When should this widget be used?&#x20;

This widget should be used when you want to monitor a single asset for alarms.&#x20;

{% hint style="info" %}
If you want an overview of all active alarms, use the widget [-> Alarm overview](/collection/english-v14/documentation/widgets/predefined-widgets/alarm-overview.md)
{% endhint %}

## Overview

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

<table><thead><tr><th width="71.33333333333331"></th><th width="231"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Header with status display</td><td>Displays the alarm status.<br>In the current image, an alarm with high priority is shown.</td></tr><tr><td><strong>[B]</strong></td><td>More options</td><td>Displays additional options.</td></tr><tr><td><strong>[B]</strong></td><td>Alarm list</td><td>The alarms for the asset are displayed here in a list.</td></tr></tbody></table>

## Configure alarm widget

<figure><img src="/files/ac22afd595e39d1a2ce8ce1ad45ca064339352d8" alt=""><figcaption></figcaption></figure>

The alarm widget displays a tabular overview of all alarms for one or more selected assets.

Here is how to configure the widget:

1. Select the **Primary asset** \[A]\
   ◈ This asset is shown in the widget title. The selection is optional.
2. Add the desired **alarm asset** \[B]\
   ◈ Alarms from this asset are displayed in the widget.\
   ◈ Multiple assets are possible.
3. Select the **Widget size** \[C]\
   ◈ The following options are available *1 Cell*, *2 Cells* or *Full Width*.
4. Select the **columns of the alarm list to be displayed** \[D]\
   ◈ Activate or deactivate individual columns with a checkmark \[D1].\
   ◈ The display order of the columns can be changed by drag & drop \[D2].
5. Click on \[E] **Save**, to apply the configuration\
   ◈ The widget will now appear in the dashboard with the selected display.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/documentation/widgets/predefined-widgets/alarm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.