> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.staple.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.staple.ai/_mcp/server.

# Alerts

This chapter explains how to be emailed when a chart crosses a threshold you care about, without watching a dashboard for it.

---

## 1. Start here: the message you will probably see first

Select **Alerts** on a new dashboard and you will most likely see this:

> **No charts on this dashboard have a goal yet. Add a goal to a chart to alert on it.**

Nothing is broken. **An alert watches a goal line**, so a chart without one has nothing to watch. Section 2 sets a goal, and then alerts become available.

**Where alerts live.** **Subscribe** and **Alerts** in the dashboard header both open the same **Notifications** panel, which has two tabs: **Subscriptions** and **Alerts**. Scheduled reports are the first tab, threshold alerts the second. [Subscriptions](/business-dashboard/subscriptions) covers the other tab.

## 2. Setting a goal line

A goal line is a horizontal marker at a value you choose. It is also the threshold an alert fires on.

1. On the chart's card, select the **...**, then **Edit question**.
2. Open the settings, the **gear** icon.
3. Go to **Display**.
4. Turn **Goal line** on.
5. Set **Goal value**.
6. Select **Save**, then **Save changes**.

Pick a value in the range your chart actually reaches. A goal far below your data sits flat on the axis, and one far above sits off the top, and neither tells a reader anything.

The chart now draws a dashed line at your value, labelled **Goal**, and can carry an alert.

## 3. Creating an alert

1. Select **Alerts** in the dashboard header.
2. The **Alerts** tab now reads **No alerts on this chart yet** instead of the goal message.
3. Select **Add alert**.
4. Under **Chart**, choose which chart to watch.
5. Give the alert a name.
6. Under **Alert me when the value**, choose **Rises above the goal** or **Drops below the goal**.
7. Select **Add**.

**There is no threshold to type in.** The form explains: *"Goal-line alerts email recipients when the chart crosses the goal set on it. There is no threshold to enter here. Set the goal when you edit the chart."* The goal **is** the threshold, which is why it has to exist first. To alert at a different number, change the goal.

## 4. When an alert fires

Analytics data refreshes periodically rather than live, and alerts are checked against the refreshed data. An alert therefore fires **on the first check after the threshold was crossed**, not at the exact moment it happens. That suits trends such as a daily upload count. For anything where minutes matter, use your operational monitoring instead.

## 5. Managing existing alerts

Alerts and subscriptions are managed from the same place.

**On this dashboard.** Select **Alerts** in the header. The panel lists the alerts already on it.

**Everywhere.** Select **Alerts & subscriptions**, under **Settings** at the foot of the dashboard list. That page holds every alert and subscription you have created, across every dashboard, with a filter for **Alerts** only.

Edit or delete from the **Actions** on a row.

Worth a look every few months. Alerts outlive the reason they were created, and an alert nobody acts on trains people to ignore the ones that matter.

## 6. Worked examples

**Volume approaching a ceiling.** Goal line on documents uploaded per day at the volume you plan for, alert when it goes above. Gives you warning before you hit it.

**Validation failures rising.** A question counting documents that failed validation in the last seven days, goal line at the count you consider normal, alert when it goes above. Catches a change in an upstream document format early.

## 7. Good to know

* **A chart needs a goal line before it can carry an alert.**
* **A seat is all you need.** If you have a Business Dashboard seat, you can create alerts.