> ## 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.
# Catalog
> Extraction of recordings, compositions, products, and commitments
Structured data fields are by definition an abstraction of legal language. When in doubt, use [citations](/projects/contracts/contract-details/citations), the [AI chat](/projects/ai-chat), and the actual contract text to validate the structured data against your own interpretation.
## Overview
The Catalog extraction identifies all music assets mentioned in the contract, organizing them into four categories: **Recordings**, **Compositions**, **Products**, and **Commitments**. The extraction happens in two phases: first the AI extracts what's written in the contract, then an enrichment agent searches external data sources to add metadata and find related works.
When you open the Catalog section, the active tab is automatically set to the first category that contains assets — Recordings, then Compositions, then Products, then Commitments — so you immediately see relevant content without having to switch tabs manually.
Sound recordings with artist credits and products.
Musical works with writer credits.
Albums, singles, and compilations linked to this contract.
Delivery obligations and deadlines.
## Recordings
### Extraction Process
1. **Contract extraction** -- the AI reads the contract and extracts every recording mentioned, capturing the title, artists, creators, identifiers (ISRC), and whether derivative works are included. You can inspect the raw output by clicking **Source**.
2. **Enrichment** -- an agent searches external data sources to find additional metadata for each recording: duration, full artist credits, album appearances, and identifiers not mentioned in the contract.
### Unique Recordings
Extracted recordings represent the **actual unique sound recordings**, identified by their specific version and duration. A recording titled "Blinding Lights" is a distinct recording from "Blinding Lights (Acoustic Version)" -- each has its own duration and ISRC.
### Derivative Works
When a contract states that derivative works are included (remixes, live versions, acoustic versions, etc.), the system automatically finds and adds those derivatives to the agreement. For example, if the contract grants rights to "Blinding Lights" with derivatives included, the enrichment agent will find and attach all known versions -- remixes, radio edits, acoustic takes, and more.
When derivatives are **not** included, only the exact version specified in the contract is matched.
### Products
For each recording, the system finds all products (albums, singles, compilations) on Spotify on which that recording appears. This gives you a complete picture of where each recording has been released.
More product sources beyond Spotify are coming soon.
### What Gets Extracted
| Field | Description |
| ------------------------ | --------------------------------------------------------------------- |
| **Title** | Recording name (exact version) |
| **Base Title** | Core title without version suffix |
| **Duration** | Track length |
| **Type** | Original or Derivative (remix, live version, etc.) |
| **Artists** | Primary and featured artists |
| **Creators** | Writers, producers, remixers, and other contributors with their roles |
| **Identifiers** | ISRC, catalog number |
| **Derivatives Included** | Whether the contract includes all derivative works of this recording |
| **Products** | Albums, singles, and compilations the recording appears on |
## Compositions
### Extraction Process
1. **Contract extraction** -- the AI extracts every composition mentioned, capturing the title, writers, identifiers (ISWC), and derivative inclusion terms.
2. **Enrichment** -- an agent searches external data sources to find the composition across releases, linking it to all known recorded versions and the products they appear on.
### How Compositions Differ from Recordings
Compositions represent the underlying musical work (melody and lyrics), not a specific sound recording. A single composition can have many recorded versions by different artists. The system searches for all known recordings of each composition and links them to the products they appear on.
Compositions are deduplicated by their title and writer combination -- ensuring each unique work appears once in your project catalog.
### What Gets Extracted
| Field | Description |
| ------------------------ | -------------------------------------------------------------------------- |
| **Title** | Composition name |
| **Base Title** | Core title without version suffix |
| **Type** | Original or Derivative |
| **Writers** | Composers and lyricists |
| **Creators** | All contributors with their roles |
| **Identifiers** | ISWC, catalog number |
| **Derivatives Included** | Whether the contract includes derivative works |
| **Products** | Albums, singles, and compilations featuring recordings of this composition |
## Products
The **Products** tab shows all albums, singles, and compilations linked to this contract via the catalog. Products are sourced from streaming platforms and stores during the enrichment phase — when recordings and compositions are extracted and matched, the releases they appear on are automatically linked to the contract.
If no products have been linked yet (for example, if enrichment is still in progress or no recordings have been matched), the tab shows an empty state.
Products are derived from your recordings and compositions — they are not extracted directly from the contract text. To see products here, recordings or compositions must first be matched in the **Recordings** or **Compositions** tabs.
Learn more about how products work across your project catalog.
## Commitments
Commitments are delivery obligations specified in the contract -- what the assignor must deliver and when.
### What Gets Extracted
| Field | Description |
| ---------------------- | ------------------------------------------------------------------------- |
| **Title** | Commitment name (e.g., "Initial Album Commitment", "First Option Period") |
| **Type** | Fixed (firm obligation) or Option (conditional on option exercise) |
| **Description** | Full terms including deadlines and conditions |
| **Recurring Schedule** | If applicable (e.g., "Every 1 year") |
### Deliverables
Each commitment lists specific items to deliver:
* Item type (album, track, composition, EP)
* Quantity required (including both named and future/unnamed works)
* How many are already fulfilled (named works already linked)
* Description or working titles
### Linked Assets
Recordings and compositions already matched to the commitment are shown grouped by album or release. As assets are added to the contract, they can be linked to their corresponding commitment.
## Adding Catalog Items
You can manually add recordings or compositions that the extraction may have missed.
How to manually add and edit recordings and compositions.
## See Also
View main recordings with primary artist credits in a simplified format. Optimized for filtering, exports, and quick reference across contracts.