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

# Understanding Alerts

> What alert emails look like, how to read them, and how to drill into the details in the portal.

When WebOrion detects a change, it sends an email alert and logs an incident in the portal. This page explains both.

***

## The alert email

<img src="https://mintcdn.com/cloudsineai/8ZIlWHy_IPpi_OxA/images/HighAlertEmail.png?fit=max&auto=format&n=8ZIlWHy_IPpi_OxA&q=85&s=36583be1680b53857d27a89f830551d5" alt="High Alert Email" width="1311" height="1162" data-path="images/HighAlertEmail.png" />

Every alert email has the same header structure:

| Field            | Description                                                                 |
| ---------------- | --------------------------------------------------------------------------- |
| **Webpage URL**  | The URL where the change was detected                                       |
| **Webpage Name** | The name you gave the webpage when adding it                                |
| **Detected**     | Timestamp when the change was detected                                      |
| **Alert ID**     | A unique ID for this incident — click it to open the incident in the portal |

Below the header, the email shows a **Change Detected** summary indicating which engine triggered the alert.

### Content & Integrity Analytics alerts

These alerts show two sections:

**Content Analytics** — a table of element counts that have changed:

| Column                  | Description                                          |
| ----------------------- | ---------------------------------------------------- |
| **Description**         | The element type (e.g. Javascripts, # of HTML Lines) |
| **Last Verified Value** | The count at the time of this alert                  |
| **Baseline Value**      | The count at the time of baselining                  |
| **Difference**          | The delta between the two                            |

**Integrity Analytics** — a list of specific elements that were modified or removed, grouped by type (e.g. Javascripts, Href Links). Each entry shows the filename or identifier of the changed element.

### Webpage Unreachable Alerts

<img src="https://mintcdn.com/cloudsineai/8ZIlWHy_IPpi_OxA/images/WebsiteUnreachableEmail.png?fit=max&auto=format&n=8ZIlWHy_IPpi_OxA&q=85&s=361c25719377a129f116c5ed2d9d0339" alt="Website Unreachable Email" width="1311" height="951" data-path="images/WebsiteUnreachableEmail.png" />

Sent when WebOrion cannot reach the page.

### User-Specified Keywords alerts

<img src="https://mintcdn.com/cloudsineai/8ZIlWHy_IPpi_OxA/images/UserSpecifiedKeywordEmail.png?fit=max&auto=format&n=8ZIlWHy_IPpi_OxA&q=85&s=7cc3ab607e8b1c3e07d6e7816d931ba2" alt="User Specified Keyword Email" width="1311" height="840" data-path="images/UserSpecifiedKeywordEmail.png" />

Sent when blacklist or whitelist keywords are triggered:

* **Blacklisted keywords found** — a keyword you've configured as forbidden was detected on the page
* **Whitelisted keywords missing** — a keyword you've configured as required was not found on the page

***

## Viewing an alert in the portal

<video src="https://mintcdn.com/cloudsineai/8ZIlWHy_IPpi_OxA/videos/AlertPage.mp4?fit=max&auto=format&n=8ZIlWHy_IPpi_OxA&q=85&s=8d6f10ce98dcb9168b0c8e1f3c22dcee" controls={true} data-path="videos/AlertPage.mp4" />

1. Go to **Alerts** in the left sidebar
2. Click on the **Alert ID** to open the incident
3. The incident page shows a summary of all changes detected, for example:

```text theme={null}
# of HTML lines differs from last verification:
Last Verified value: 3495 | Current verified value: 5144 | Difference: 1649

Javascript (In-line_JS_#28) differs from current verification.
```

## Drilling into file changes

<img src="https://mintcdn.com/cloudsineai/8ZIlWHy_IPpi_OxA/images/AlertCodeDiff.png?fit=max&auto=format&n=8ZIlWHy_IPpi_OxA&q=85&s=84f4d36dd58f18d0caa9d65a9016d92c" alt="Alert Code Diff" width="4367" height="2401" data-path="images/AlertCodeDiff.png" />

For alerts involving specific Javascript or CSS files, you can view the exact diff:

1. From the incident page, click on the specific file that changed
2. The diff view opens with a side-by-side comparison:

| Column            | Description                                               |
| ----------------- | --------------------------------------------------------- |
| **Left (red)**    | The state of the file at the time the alert was triggered |
| **Right (green)** | The previous baseline state of the file                   |

Changed lines are highlighted, making it easy to identify exactly what was added, removed, or modified.

<Tip>
  If the change looks authorised — a planned content update or a script version bump — re-baseline the page to clear the alert and set the new state as the reference. See [Re-baselining Webpages](/defacement-monitor/managing-changes/re-baselining).
</Tip>
