> 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/alarms-rules-and-escalations/escalations/configure-an-escalation.md).

# Configure an escalation

## Overview

The "Configure Escalation" menu is divided into 5 elements.

<div data-full-width="true"><figure><img src="/files/4a5d6af26dcb5da5b046de02a12792aadda41ed9" alt=""><figcaption><p>Fig. 1 – The "Configure Escalation" menu in the empty state</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="110.33333333333331"></th><th width="170"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Escalation Name</td><td>Here you can subsequently adjust the name of the escalation</td></tr><tr><td><strong>[B]</strong></td><td>General calendars</td><td>Here you select the general calendar.</td></tr><tr><td><strong>[C]</strong></td><td>Tags to escalate</td><td>Here you specify which alarms are escalated. </td></tr><tr><td><strong>[D]</strong></td><td>Tags with users and targets</td><td>Here you specify to which users an alarm is escalated. </td></tr><tr><td><strong>[E]</strong></td><td>Calendars and schedules</td><td>Here you can see details and make further adjustments</td></tr></tbody></table>

## 1 – Add general calendar

### 1.1 – Overview

In this step you select **WHEN** an alarm should be escalated.

This is done by selecting 1 or more *General calendars* Only on dates selected in these calendars are alarms escalated.&#x20;

The *General calendars* are selected in **element \[B]** . In Fig. 2, 1 general calendar was **\[B7]** added. The dates selected in the calendar are also displayed.&#x20;

{% hint style="info" %}
If no general calendar is available: Here you can learn how to [-> create a general calendar](/collection/english-v14/documentation/alarms-rules-and-escalations/escalations/create-a-general-calendar.md).&#x20;
{% endhint %}

After a calendar has been added, **element \[E]** a **timeline \[E1] appears.** Using this timeline, you can also see when the alarm is escalated. In Fig. 2, for example, an interruption was inserted on November 1. This means that no escalations would take place on November 1.&#x20;

<div data-full-width="true"><figure><img src="/files/28b94017ab41b8356d0c045a3adf9605d88df3b6" alt=""><figcaption><p>Fig. 2 – Selecting a general calendar</p></figcaption></figure></div>

### 1.2 – Step-by-step instructions

1. Click on **\[B1]** to add a general calendar\
   ▷ The window **\[B2]** appears
2. Select in **\[B3]** select a general calendar\
   ▷ The selected calendar is displayed in **\[B4]** displayed\
   ▷ In **\[B6]** you can see the validity dates for the added general calendar
3. Optional: Select additional general calendars
4. Click on **Add \[B6]**

## Step 2 – Tags to escalate

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

#### 2.1 – Overview

In this step you determine **which** alarms are escalated.&#x20;

For this you use [-> tags](/collection/english-v14/documentation/tags.md).&#x20;

As described in chapter [-> Alarms](/collection/english-v14/documentation/alarms-rules-and-escalations/alarms.md) each alarm is based on a [-> rule](/collection/english-v14/documentation/alarms-rules-and-escalations/rules.md). You can assign 1 or more tags to rules.

In window **\[C]** you can specify 1 or more tags. Only alarms triggered via a rule that has the same tags as those also specified in window **\[C]** are escalated. &#x20;

#### 2.2 – Step by step

1. Click on **\[C1]**, to add one or more tags for escalation
2. Added tags appear in the element **\[C]**

## Step 3 – Tags with users and targets

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

### &#x20;3.1 – Overview

In this step you select to which users the alarm should be escalated.&#x20;

Just like with alarms, you use [-> tags](/collection/english-v14/documentation/tags.md).&#x20;

In window **\[D]** you can specify 1 or more tags. Users who are assigned this tag are then added.&#x20;

Alarms are escalated to these users.

### 3.2 – Step by step

1. Click on **\[D1]**\
   ▷ The window **\[D2]** opens
2. Select under **\[D3]** tags
3. Click on **\[D4]**\
   ▷ All users who have the selected tags appear in **element \[D]**\
   ▷ All users who have the selected tags appear in **element \[E]**

## Step 4 – Select escalation channel

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

### 4.1 – Overview

In this step you determine on which escalation channel alarms are escalated to a user.

This can be configured individually for each user.

### 4.2 – Step by step

1. For the user for whom you want to select the escalation channel: Click on **Edit schedule \[D6]**\
   ▷ The window **\[F]** opens\
   ▷ In the line **\[F1]** You can see all escalation channels. Unavailable escalation channels are grayed out
2. Click on the desired escalation channel
3. Activate the switch **\[F5]**\
   ▷ The escalation will be enabled for those shown in **\[F2]** displayed
4. Click on **Save \[FX]**
5. &#x20;Click on **\[D5]** to test the escalation

## Step 5 – Schedules&#x20;

### 5.1 – Overview

You can adjust a precise schedule for each user to whom an alarm is escalated. This schedule specifies the [-> general calendar](/collection/english-v14/documentation/alarms-rules-and-escalations/escalations/create-a-general-calendar.md).&#x20;

The schedules can be configured individually per user and per escalation channel.&#x20;

This makes it possible, for example, to notify a user during normal working hours by email and SMS, but after working hours only by email.&#x20;

A separate schedule can be created for each escalation channel, or a standard schedule can be used.

This is the standard schedule for this user. This schedule applies ONLY TO THIS USER!

Must not be confused with the general calendar.

### 5.2 – Adjust standard schedule&#x20;

1. For the user for whom you want to adjust the schedule: Click on **Edit schedule \[D6]**\
   ▷ The window **\[F]** opens\
   ▷ In the line **\[F1]** the Standard Schedule tab is selected.&#x20;
2. In field **\[F2]** you can adjust the standard schedule.
3. In field **\[F3]** you can insert exceptions
4. Click on **Save \[FX]**, to adopt the standard schedule

### 5.3 – Apply standard schedule to an escalation channel

1. For the user for whom you want to apply the standard schedule: Click on **Edit schedule \[D6]**\
   ▷ The window **\[F]** opens\
   ▷ In the line **\[F1]** You can see all escalation channels. Unavailable escalation channels are grayed out
2. Click on the desired escalation channel
3. Make sure that the switch **\[F5]** is activated
4. Activate the switch **\[F4]**\
   ▷ The area **\[F2]** will be grayed out\
   ▷ In the area **\[F2]** the values appear that you configured in [-> 5.2 Adjust standard schedule](/collection/english-v14/documentation/alarms-rules-and-escalations/escalations/configure-an-escalation.md#schritt-5-zeitplaene) .
5. Click on **Save \[FX]**
6. Repeat this process for each escalation channel to which you want to apply the standard schedule

### 5.4 – Apply an individual schedule to an escalation channel

You can use an individual schedule for each escalation channel.

1. For the user for whom you want to apply the standard schedule: Click on **Edit schedule \[D6]**\
   ▷ The window **\[F]** opens\
   ▷ In the line **\[F1]** You can see all escalation channels. Unavailable escalation channels are grayed out
2. Click on the desired escalation channel
3. Make sure that the switch **\[F5]** is activated
4. Make sure that the switch **\[F4]** is deactivated
5. Configure in **area \[F2]** the individual schedule\
   ◈ This individual schedule applies only to the escalation channel in which it was configured!
6. Optional: Repeat the process for all desired escalation channels


---

# 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/alarms-rules-and-escalations/escalations/configure-an-escalation.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.
