> For the complete documentation index, see [llms.txt](https://help.seoutils.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/alerts.md).

# Alerts

Alerts tell you when something real happens to a keyword, so you do not have to watch the table. The tracker checks for alerts after each refresh, and you can read them in the **Alerts** tab, get a desktop notification, or send them by email or webhook with an [automation](https://help.seoutils.app/guide/automations.md).

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-fd7af442e2d99c587c15a2398b99b6cea72a8324%2Fgsc-rankings-alerts-tab.png?alt=media" alt="The Alerts tab listing recent alerts with their type, positions and page"><figcaption><p>The Alerts tab</p></figcaption></figure>

## When an alert fires

There are six types of alerts. They use final data only, and a position change must hold on two separate days, so a one-day spike never alerts.

| Type                         | Fires when                                                                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Top 3 / 10 / 20 crossing** | A keyword enters or leaves the top 3, top 10 or top 20, confirmed on two separate days.                                                                                        |
| **Moved**                    | A keyword moves at least the **move threshold** without crossing one of those edges, confirmed on two separate days.                                                           |
| **Wrong page**               | You set a target page, and Google showed another page on at least 2 days with enough impressions in the last 7 days.                                                           |
| **Split**                    | A second page of yours got a quarter or more of the impressions on at least 2 such days in the last 7 days.                                                                    |
| **Vanished**                 | A keyword that had impressions for a while gets none for 7 days. It may have dropped out of the top 100 or become anonymised.                                                  |
| **New in a rule**            | A new query joined one of your [rules](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/read-your-rankings.md#rules) and already sits inside the top 10. |

You get **one alert per real change**. A keyword that drops out of the top 10 alerts once, not at every refresh. If it recovers and later drops again, that is a new alert.

{% hint style="info" %}
A new keyword or tracker never alerts about its past. Alerts start after the 16 months of history are downloaded.
{% endhint %}

## Read and manage alerts

Open the **Alerts** tab. Each row shows:

| Column        | What it shows                                                                                                                                                                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Day**       | The final-data day the alert was confirmed on (Pacific Time). An unread alert has a dot in front of it.                                                                                                                                                                  |
| **Keyword**   | The keyword or rule. Click it to open its [details](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/keyword-details.md).                                                                                                                          |
| **Type**      | What happened, in words: "Dropped out of the top 10", "Improved 7 positions", "Google shows /page instead of your target".                                                                                                                                               |
| **From → To** | The position before and after, rounded; hover for the exact values. A vanished keyword reads "25 → not shown", a new rule member "new → 8", and a wrong page or split shows only the position now.                                                                       |
| **Page**      | The page path involved. A crossing or a move shows the page, or "/old → /new" when Google switched pages. A wrong page shows your target and the page Google shows instead, a split shows the main page and the second page, and a vanished keyword shows "last: /path". |

* Filter with **Type** and **Unread only**, or search by keyword.
* Click **Mark all read**, or tick rows and use **Mark read**. The row menu has **Open**, which shows the keyword around the day of the alert, and **Mark read**.
* Alerts are kept for 365 days.

Unread alerts show up in several places, so you notice them without opening the tab: the **Alerts (n)** tab label, the **Unread alerts** figure in the KPI strip, a dot or number in the tracker selector, and a badge on **Rankings** in the page menu of the top bar.

## Move threshold

The **move threshold** is how many positions a keyword must move to count as a move, for **Moved** alerts and for the [Movers](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/movers.md) tab. The default is 5.

Set it in the wizard's last step, or later in the tracker's **Settings** (click the tracker's name at the top), under **Move threshold**. It must be a whole number from 1 to 100. When you save a new value, the open alerts are checked again against it.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-f99ec65a50f3310e2a76b33a6c5dff7add2cc0fa%2Fgsc-rankings-settings-sheet.png?alt=media" alt="The tracker settings with Thin threshold, Move threshold and Desktop notifications"><figcaption><p>Move threshold and Desktop notifications in the tracker settings</p></figcaption></figure>

## Desktop notifications

Turn on **Desktop notifications** in the wizard or in the tracker settings. When a refresh finds new alerts, SEO Utils shows one notification for that tracker, not one per alert. Click it to open the tracker's **Alerts** tab.

* The first time you turn it on, your computer may ask you to allow notifications from SEO Utils. If they are blocked, the setting shows an **Allow notifications** link or tells you where to switch them on in the system settings.
* Notifications appear in the SEO Utils desktop app. The Alerts tab lists every alert either way.

## Send alerts by email or webhook

Use the **GSC Rank Tracker Alerts** trigger in [Automations](https://help.seoutils.app/guide/automations.md) to send new alerts to your inbox or to another tool.

{% stepper %}
{% step %}

#### Create an automation

Go to **Automations** in the sidebar, click **Create Automation** and give it a name.
{% endstep %}

{% step %}

#### Choose the trigger

Open the trigger list and choose **GSC Rank Tracker Alerts**. Under **Apply to**, pick **All reports** or **Specific reports** to limit it to some trackers.

Then narrow down what you receive:

* **Alert types**: tick the types you want. Leave all unticked to receive every type.
* **Only keywords in**: **Any position**, **Top 3**, **Top 10** or **Top 20**. Only alerts of keywords that were or are in this range are sent.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-08f78e10a96d7a03a36f8bd263e229fce7ae3112%2Fgsc-rankings-automation-trigger.png?alt=media" alt="The automation trigger step for GSC Rank Tracker Alerts with alert types and a position filter"><figcaption><p>Choose which alerts the automation sends</p></figcaption></figure>
{% endstep %}

{% step %}

#### Add an action

This trigger supports **Export PDF**, **Send Email** and **Webhook**. **Export PDF** saves the tracker's [report](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/print-and-pdf.md#send-it-with-an-automation). Send Email needs your [SMTP credentials](https://help.seoutils.app/guide/smtp-credentials.md); until they are set up it shows as unavailable.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-eb6ec316be235290aa6206e6870a03e2bda34c70%2Fgsc-rankings-automation-actions.png?alt=media" alt="The action type list with Export PDF, Send Email and Webhook"><figcaption><p>Export PDF, Send Email and Webhook are the actions for this trigger</p></figcaption></figure>
{% endstep %}
{% endstepper %}

The automation runs **once per refresh** with all the new alerts of that tracker, not once per alert. If its filters leave no alert, nothing is sent.

<details>

<summary>Variables and webhook payload</summary>

In an email subject or body, use these variables:

| Variable                                                                                               | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{{trigger.trackerName}}`                                                                              | The tracker's name                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `{{trigger.propertyDomain}}`                                                                           | The Search Console property                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `{{trigger.market}}`                                                                                   | Country and device                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `{{trigger.alertsCount}}`                                                                              | Number of alerts sent                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `{{trigger.alertsSummary}}`                                                                            | The alerts in a few words, for example "3 dropped, 1 wrong page"                                                                                                                                                                                                                                                                                                                                                                                              |
| `{{trigger.alertsList}}`                                                                               | One line per alert, up to 20                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `{{trigger.fromDate}}` and `{{trigger.toDate}}`                                                        | The first and last day an alert was confirmed on                                                                                                                                                                                                                                                                                                                                                                                                              |
| `{{trigger.reportFrom}}` and `{{trigger.reportTo}}`                                                    | The first and last day of the report period: the 30 days ending on the tracker's latest final day. The Export PDF action covers them                                                                                                                                                                                                                                                                                                                          |
| `{{trigger.kpis.tracked}}`, `{{trigger.kpis.avgH}}`, `{{trigger.kpis.top3}}`, `{{trigger.kpis.top10}}` | The tracker's headline figures                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `{{trigger.aiSummaryText}}`                                                                            | This week's AI summary as one paragraph. Empty when the [weekly summary](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/ai.md#weekly-summary) is off or not written yet. It starts "This week (Oct 1 – Oct 7), written by AI (provider and model):", or "This week (Oct 1 – Oct 7):" when the tracker's [AI label](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/ai.md#hide-the-ai-label-for-clients) is off |

A webhook receives JSON with the tracker, the property, the filtered `alerts` and the headline `kpis`:

{% code title="Webhook payload (shortened)" %}

```json
{
  "event": "gsc_rank_alerts",
  "tracker": { "id": 7, "name": "US · All devices · Web" },
  "property": { "domain": "harborpine.example" },
  "alerts": [
    {
      "keyword": "best coffee grinder",
      "type": "band_cross",
      "direction": "down",
      "from": 4.1,
      "to": 14.3,
      "band": 10,
      "page": "https://harborpine.example/products/coffee-grinder",
      "confirmedDate": "2026-10-11"
    }
  ],
  "kpis": { "tracked": 102, "avgH": 8.1, "top3": 15, "top10": 51 }
}
```

{% endcode %}

With the weekly AI summary on and written, the payload also has an `aiSummary` object with the week, the text, its evidence, the provider and the model. It keeps the provider and model even when the tracker's AI label is off.

</details>
