# Detailed List of Alarms

The *Detailed List of Alarms* widget in BuildingPro Suites offers a detailed display of alarms that have been triggered by specific rules. It allows for flexible filtering of alarms based on selected tags to display only relevant information.

{% hint style="info" %}
This widget must be created as a [-> Custom Widget](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/custom-widgets) and is created with the [-> Alarm](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/alarm) module.
{% endhint %}

<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%2FmjpIcp2cMQKYwA9GVT7T%2FAlarm%20detailled%20(2).png?alt=media&#x26;token=835a24f0-9b80-46fa-b821-f776dadb36e7" alt=""><figcaption></figcaption></figure></div>

## Widget

The widget displays the alarms as in the[ -> Detailed View of Alarms.](https://docs.buildings.ability.abb/collection/platform/alert-center/alarms)

## When should this widget be used?

The **Detailed List of Alarms** display is used when a precise and comprehensive overview of all alarms is required. It is particularly suitable for filtering and displaying alarms based on tags. This display shows not only the alarms of one asset but all alarms with the selected tags. If no tags are selected, all alarms are displayed. This differs from other alarm widgets, which are limited to specific asset-related alarms or simple alarm counts and are less detailed.

## Configure Widget

<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%2FynMJHXkJ1a6UnAxtQJTh%2FAlarm%20detailled%20(1).png?alt=media&#x26;token=423ff861-178d-4d11-94f9-47d3aca577ec" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="57.20001220703125"></th><th width="145.39996337890625"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Primary Asset</td><td>Select the primary asset. This selection determines which title <strong>[A]</strong> appears in the widget.</td></tr><tr><td><strong>[B]</strong></td><td>Width</td><td>Choose how much space the widget should occupy on the dashboard.</td></tr><tr><td><strong>[C]</strong></td><td>Tag Setting</td><td><p>You can filter alarms by specific tags to display only relevant alarm data.</p><ul><li><strong>All selected required</strong>: Only alarms that have all selected tags are displayed.</li><li><strong>One of the selected</strong>: Displays alarms that have at least one of the selected tags.</li></ul></td></tr><tr><td><strong>[D]</strong></td><td>Select Tags</td><td>Select the tags by which the alarms in the widget should be filtered to display only the relevant alarms.</td></tr></tbody></table>


---

# 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/custom-widgets/detailed-list-of-alarms.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.