> For the complete documentation index, see [llms.txt](https://docs.eu-pactum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eu-pactum.com/price-lists/index-catalogue/index-alerts.md).

# Index alerts

Set an index alert to get an email when an index crosses a price you care about or moves sharply.

## Set an alert

1. Go to **Portfolio** > **Indices** and open an index.
2. Click **Set alert**.
3. Under **Trigger**, choose one:
   * **Outside a range**: enter a **Lower bound** and an **Upper bound**.
   * **Rises above** or **Falls below**: enter a **Threshold**.
   * **Moves by %**: enter the **Change** and pick the period it is measured **Over**: **7d**, **30d** or **90d**. Moves up and down both count.
4. Under **Notify**, enter an **Email**. To add more people, list them in **Also notify (optional)**, separated by commas.
5. Choose a **Frequency**: **Immediately**, **Daily digest** or **Weekly digest**.
6. Check the summary line ("Email me when …") and click **Create alert**.

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2FLX4m7VSTS5QhfUk4LLwD%2Fimage.png?alt=media&amp;token=99cc0d88-9859-4a89-8db7-c55e47ad323f" alt=""><figcaption></figcaption></figure>

## Manage your alerts

Click **Index alerts** at the top of the catalogue. Alerts belong to the workspace, so everyone in it sees the same list.

* **Alert history** lists every time an alert fired, with the materials affected, the spend exposed and whether the email is **Sent** or **Pending**. Click a row to open it.
* **Configured alerts** lists each alert with its trigger, delivery, recipients, when it last fired and its status (**Active** or **Paused**). The row menu has **Edit**, **Send test**, **Pause** or **Resume**, and **Delete alert**. A deleted alert stops sending, including any firings still **Pending**; its past firings stay in **Alert history**.

**Send test** emails every recipient a "\[Test]" copy built from the latest value, whether or not the condition is met. It isn't added to the history. An index's **Alerts** and **Notifications** tabs show the same for that index.

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2FEPhmmHXHhOICEwP2qIoa%2Fimage.png?alt=media&amp;token=d912b1c6-5a6a-44ba-a24d-5ee6d2cf5faa" alt=""><figcaption></figcaption></figure>

## How to read it

An alert's page and its email show the same snapshot, taken when it fired:

* the index's latest value and date, and how much it moved
* **Linked materials**, **Suppliers**, **Spend driven** (the index's [driven spend](https://docs.eu-pactum.com/price-lists/reference/glossary.md)) and **Share of portfolio**
* **Est. annual impact**: driven spend multiplied by the move, assuming it passes through in full
* **Most affected materials**, with cost share, driven spend and estimated impact (up to 10 in the email)

<figure><img src="https://2769938103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FM7KTpbu7nDWmneLhlf%2Fuploads%2FMwdGZfqhUXJC50Zo58d6%2Fimage.png?alt=media&amp;token=7165cac4-85f1-4997-9d83-d371b52d399f" alt=""><figcaption></figcaption></figure>

## Good to know

* **Alerts are checked once a day.** A new alert first takes a baseline reading without emailing you, even if the condition is already true.
* **No repeat emails.** **Rises above**, **Falls below** and **Outside a range** email you when the index crosses the line, and not again until it crosses back and over again. **Moves by %** emails once per new published value whose move clears your percentage.
* **The window follows the index.** On a monthly index, a **7d** or **30d** move is measured against the previous published value. The alert's page notes when this happens.
* **Out-of-date indices don't fire.** If an index stops publishing, its alerts wait for fresh data.
* **Digests.** A daily digest arrives on each day with something to report; a weekly one on Mondays, in your workspace's time zone. Largest impact comes first. Until it goes out, the firing shows as **Pending**.
* **Alerts you didn't set.** When you approve a proposed cost structure, Price Lists may add an alert on each linked index that has no active alert. It emails you immediately when the index falls 5% or more over 90 days, and shows as **Moves by 5% over 90d**.
* **View-only users** see **Set alert** greyed out.

## Ask the Assistant

* "Find the copper index for Europe and show how it moved over the last 3, 6 and 12 months."
* "How has the copper index moved since January?"

## Related

* [Find and compare indices](https://docs.eu-pactum.com/price-lists/index-catalogue/browse-and-compare-indices.md)
* [Find and understand a material (Materials)](https://docs.eu-pactum.com/price-lists/portfolio/materials.md)
* [Glossary](https://docs.eu-pactum.com/price-lists/reference/glossary.md)
