---
title: "Alerts - Create a new Alert"
slug: "alerts-create-a-new-alert"
updated: 2025-01-20T13:40:14Z
published: 2025-01-20T13:40:14Z
canonical: "docs.mapp.com/alerts-create-a-new-alert"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Alerts - Create a new Alert

## Location

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/grafik(81).png) *Feed > Notifications > Alerts > Create new alert*

You can create alerts for the selected account or select a predefined alert template from the Alert Library.

The predefined alert templates enable you to create smart alerts quickly. You don't have to worry about which metric or dimension to apply. You must only decide when you want to be notified, for example, when "the engagement of the users changes”. The associated metrics and dimensions are filled in automatically.

## Alert Library

|  | Description |
| --- | --- |
| **Alert me when:** | Optional: Select one of the predefined alert templates from the area you are interested in, for example "Marketing", "E-Commerce" or "Engageme” |

## Alert Settings

|  | Description |
| --- | --- |
| **Metric** | Choose the metric that you want to monitor. \| If you select an alert template from the Alert Library, you must not change anything here. The fields **Metric** and **Grouped by dimension** are filled in automatically. \| \| --- \| |
| If you select an alert template from the Alert Library, you must not change anything here. The fields **Metric** and **Grouped by dimension** are filled in automatically. |
| **Grouped by dimension** | Select if you want to filter a metric by a dimension. - Top [X]: Select how many dimension values should be monitored. **Example** Metric: [*Visits*](/v1/docs/metrics-visits) Dimension: [*Device Class*](/v1/docs/device-class)*,* Top 3 Result: The number of visits for each Top 3 Device Classes is monitored. \| If you select an alert template from the Alert Library, you must not change anything here. The fields **Metric** and **Grouped by dimension** are filled in automatically. \| \| --- \| - You can add additional filters to the dimension by clicking on **Filter**. The available operators are: - Equals / Not equals - In list / Not in list **Example** ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/grafik(83).png) |
| If you select an alert template from the Alert Library, you must not change anything here. The fields **Metric** and **Grouped by dimension** are filled in automatically. |
| **Alert type** | - **Smart Alert** Based on machine learning, the system will automatically compare historical data to current data. If there is a significant change, you get informed. - **Rule-based Alert** You select the criteria when an Alert should be triggered. - Change by absolute: checks for a change of an absolute number - Change by %: checks for a change of a relative share - Greater than: checks for an absolute number - Smaller than: checks for an absolute number - **Comparison Timeframes** Alerts compare changes between two time periods: - Yesterday with day in previous week - Last 7 days with previous 7 days - Last month with previous month - Last month with same month last year - Last 7 days with same 7 days before |
| **Sensitivity** (only for Alert type **Smart Alert**) | It lets you decide how tolerant the trigger is to unexpected values. |
| **Anomalies** | What kind of changes the alert is triggered by. This can be either Spikes, Drops, or both. |
| **Frequency** | Determines how often an alert is checked. - **Hourly:** Once per hour. Data is always checked for the hour before the last hour, as it must be assured that all data is available. Example: An alert recognized at 11am shows an anomaly for the hours 9–10. - **Daily:** Once per day. The check is done in the morning (system time) when the data for the previous day is available. |

## Alert Information

|  | Description |
| --- | --- |
| **Name** | This name is used in the notifications when this alert is triggered. We recommend providing a self-explanatory name. |
| **Description** | This description is displayed in the alert overview. You can use it to give an idea of what this alert is about. |
| **Spike Message** | You can add a message in the email when the value is higher than expected. \| If you select an alert template from the Alert Library, a Spike Message is prefilled. The message details possible reasons. \| \| --- \| |
| If you select an alert template from the Alert Library, a Spike Message is prefilled. The message details possible reasons. |
| **Drop Message** | You can add a message in the email when the value is lower than expected. \| If you select an alert template from the Alert Library, a **Drop Message** is prefilled. The message details possible reasons. \| \| --- \| |
| If you select an alert template from the Alert Library, a **Drop Message** is prefilled. The message details possible reasons. |
| **Recipient’s Email** | Add all email addresses to which the alert should be sent. Use ";" as a separator. |

## Related

- [Use Smart Alerts for automatic notifications if relevant things happen](/use-smart-alerts-for-automatic-notifications-if-relevant-things-happen.md)