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

# Alerts

> Stay ahead of upcoming contract dates that need action

## What are Alerts?

The **Alerts** tab surfaces upcoming contract dates that need your attention, so nothing important slips past. Alerts are derived from your contracts' timeline end dates -- expirations, option deadlines, renewal windows, payment dates, and similar events -- and are grouped by the month they fall in.

<Info>
  Alerts are generated automatically from the dates extracted on your contracts. There is nothing to configure -- as contracts are processed, their key dates appear here.
</Info>

## Accessing Alerts

Navigate to **Dashboard** → **Alerts** tab. The header shows the total number of alerts to act on.

## Cycle Overview

At the top of the page, two cards give you a quick read on what's coming:

| Card              | What it shows                                                     |
| ----------------- | ----------------------------------------------------------------- |
| **Current cycle** | Upcoming alerts within the current cycle, laid out month by month |
| **Next cycle**    | Alerts falling in the following cycle                             |

Each card shows a month-by-month timeline. Months that contain one or more alerts are marked, and a count shows how many alerts land in that cycle.

## Alerts List

Below the overview, alerts are grouped into **month cards**, ordered from the nearest date onward.

Each month card shows:

* The **month and year**
* A **Soon** badge when the month falls in the current year
* The number of **contracts** with alerts that month, plus counts of affected **recordings** and **compositions** where applicable

Click a month to expand it and see the individual contracts.

### Contract cards

Inside an expanded month, each contract appears as a card showing:

| Element           | Description                                                                        |
| ----------------- | ---------------------------------------------------------------------------------- |
| **Parties**       | Assignee and assignor entities (or the contract file name when no parties are set) |
| **Contract type** | The classified type of the contract                                                |
| **Summary**       | A short preview of the contract summary                                            |
| **Alert rows**    | One row per upcoming date                                                          |
| **View Contract** | Opens the full contract details                                                    |

Each alert row breaks down the date:

| Field           | Meaning                                                              |
| --------------- | -------------------------------------------------------------------- |
| **Category**    | The kind of date (e.g., expiration, option, renewal)                 |
| **End date**    | The date the alert fires on                                          |
| **Basis**       | How the date was determined                                          |
| **Estimated**   | A badge shown when the date is an estimate rather than an exact date |
| **Description** | Any extra context extracted for that date                            |

<Tip>
  Use **View Contract** on any card to jump straight to that contract's details and take action.
</Tip>

## Filtering and Sorting

Use the controls in the top-right of the page to focus the list.

### Filters

| Filter    | Options                                  |
| --------- | ---------------------------------------- |
| **Cycle** | All cycles, Current cycle, or Next cycle |
| **Year**  | Limit alerts to a specific year          |
| **Type**  | Limit alerts to a specific date category |

A badge on the filter button shows how many filters are active. Use **Clear all** to reset them.

### Sort

Sort the list by **Date**, ascending or descending.

## Pagination

Alerts are paginated. Use the pagination controls at the bottom of the list to move between pages, and adjust how many items are shown per page.

## Empty State

When there are no alerts -- or none that match your current filters -- the page shows a message confirming there is nothing to act on.

## Related Features

<CardGroup cols={2}>
  <Card title="Reviews" icon="clipboard-check" href="/projects/dashboard/reviews">
    Contracts flagged for review, with repair verdicts to act on.
  </Card>

  <Card title="Contract Timeline" icon="calendar" href="/projects/contracts/timeline/overview">
    The full timeline view across all contracts.
  </Card>
</CardGroup>
