> ## 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.

# Calendar

> Bird's eye view of statement coverage by entity and year

## Overview

The Calendar provides a visual overview of your statement coverage across entities and years. It helps you identify missing statements, track reporting completeness, and audit your royalty data against contract expectations.

## How It Works

The Calendar displays:

| Element     | Description                                                      |
| ----------- | ---------------------------------------------------------------- |
| **Rows**    | Entities that owe you royalty statements based on your contracts |
| **Columns** | Years in a 5-year sliding window                                 |
| **Cards**   | Statement count for each entity/year combination                 |

Click any year card to see detailed statement information and audit status.

<Note>
  Years that fall before an entity's first contracted year appear **dimmed** and aren't clickable. The exception is any year that already has statements — those cards stay fully active and openable, so you never lose access to data you've uploaded.
</Note>

### Which Entities Appear

Entities shown in the Calendar come from your uploaded royalty contracts where:

1. **You are the assignor** — your project entity (or one of its [aliases](/projects/crm/entities)) assigned rights to the other party
2. **The contract includes royalty obligations** — the assignee (label, distributor, collecting society, etc.) is obligated to pay you royalties or profit shares

This ensures the Calendar only tracks entities that should be sending you statements, based on your contractual relationships.

## Switching Asset Types

Use the dropdown in the header to switch between:

| Type             | Description                                       |
| ---------------- | ------------------------------------------------- |
| **Recordings**   | Statements for sound recording (master) royalties |
| **Compositions** | Statements for publishing (songwriting) royalties |

## Year Navigation

Navigate through years using the arrow buttons in the header. The calendar shows 5 years at a time, centered around the current year by default.

## Loading Entities

The Calendar loads entities as you scroll down. If your project has many entities, additional rows appear automatically.

## Entity Sidebar

The sidebar shows each entity with:

* **Entity name** — click to open the entity in CRM
* **Contract count** — number of royalty contracts linked
* **Asset count** — recordings or compositions covered

### Linked Contracts & Assets

Each entity row has a **chevron** button (▾) on the right. Click it to open a dropdown listing the specific contracts and assets behind that entity's counts:

* **Contracts** — every royalty contract linked to the entity. Click one to open the contract details in a new tab.
* **Recordings** or **Compositions** — the assets covered, matching the asset type selected in the header. Click one to open the asset details in a new tab.

<Tip>
  The dropdown only appears when the entity has at least one linked contract or asset. Use it to jump straight from a coverage gap to the underlying contract or catalog item.
</Tip>

The sidebar displays up to 50 entities at a time. If you have more, a **Load more** button appears at the bottom of the list. Click it to load the next batch. Use the search bar to quickly find a specific entity.

## Statement Details

Click any year card to open a sheet with two tabs. The sheet header summarises how many statements were found alongside the entity's full contract and asset totals — the same totals shown on the entity's sidebar card.

### Statements Tab

Shows all statements for that entity/year, grouped by accounting interval:

| Interval    | Expected             |
| ----------- | -------------------- |
| Monthly     | 12 statements        |
| Quarterly   | 4 statements (Q1–Q4) |
| Half-Yearly | 2 statements (H1–H2) |
| Yearly      | 1 statement          |

Each statement card displays:

* Processing status (uploading, processing, ready, warnings, errors)
* Accounting period (e.g., Q2 2024)
* Statement type (recording/publishing)
* File name
* Content types detected

### Audit Tab

Checks whether you received the expected statements based on your royalty contracts:

| Status      | Meaning                                                       |
| ----------- | ------------------------------------------------------------- |
| **Passed**  | All expected statements received for all accounting intervals |
| **Flagged** | Missing statements for one or more intervals                  |

The audit compares:

* **Expected** — what your contracts say you should receive (based on accounting period settings)
* **Received** — distinct statements uploaded for each interval

## Related Features

<CardGroup cols={2}>
  <Card title="Files" icon="file-lines" href="/projects/statements/files/overview">
    View and manage all uploaded statement files.
  </Card>

  <Card title="Advanced Insights" icon="chart-pie" href="/projects/statements/advanced-insights">
    Analyze revenue across periods.
  </Card>
</CardGroup>
