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

# Recordings

> Manage master recordings in your catalog

## Overview

Recordings represent master sound recordings - the actual audio files that are distributed to streaming platforms and stores. Each recording has a unique ISRC (International Standard Recording Code) that identifies it globally.

## Recording Information

### Core Fields

| Field            | Description                           | Required    |
| ---------------- | ------------------------------------- | ----------- |
| **Title**        | Recording title                       | Yes         |
| **ISRC**         | International Standard Recording Code | Recommended |
| **Duration**     | Track length                          | No          |
| **Release Date** | When released                         | No          |
| **Version**      | Original, remix, live, etc.           | No          |

### Artist Information

| Field                | Description                |
| -------------------- | -------------------------- |
| **Primary Artist**   | Main performing artist     |
| **Featured Artists** | Featured performers        |
| **Producer**         | Recording producer         |
| **Contributors**     | Musicians, engineers, etc. |

## Viewing Recordings

### List View

The recordings list shows:

* Recording title and artist
* ISRC code
* Release date
* Products (albums/singles/compilations with their source store)
* Linked contracts
* Statement earnings

### Filters

Filter recordings by:

* **Artist** - Primary or featured artist
* **Creator** - Who created the catalog entry
* **Matched** - Whether the recording is matched to statement data
* **Source** - Where the recording originated (contract or statement)
* **Match Type** - How the recording was matched (e.g. UPC & ISRC, ISRC only, Asset & Product, UPC only, Album only)
* **Match Store** - The DSP store the match came from (e.g. Spotify, Apple Music, YouTube)

### Search

Search recordings by:

* Title (partial match)
* ISRC (exact match)
* Artist name
* Album title

## Recording Detail View

Click on any recording to see its full details:

### Banner Section

* Recording title and primary artist
* Cover art (when available)
* Key metadata at a glance

### Tabs

<Tabs>
  <Tab title="Overview">
    Basic recording information including title, ISRC, artists, and metadata.
  </Tab>

  <Tab title="Contracts">
    All contracts that reference this recording, showing rights holders and terms. A summary bar at the top displays the unique ISRCs and UPCs found across those contracts, each with a copy button so you can quickly copy the values to your clipboard.
  </Tab>

  <Tab title="Products">
    Albums, EPs, and singles that contain this recording.
  </Tab>

  <Tab title="Statements">
    Royalty statement data for this recording, including earnings by source.
  </Tab>
</Tabs>

## Adding Recordings

### From Contract Extraction

Recordings are automatically added when contracts mention them:

1. Upload a contract to Smart Drive
2. AI extracts recording references
3. Streaming platform data enriches metadata (artwork, duration, full credits)
4. Recordings appear in your catalog linked to the contract

### Manual Addition via Contract

To add recordings not captured by extraction:

1. Open the contract in Contract Details
2. Navigate to the Catalog section
3. Use the [Edit Catalog](/projects/contracts/contract-details/structured-data/edit-catalog) feature to search Spotify and add recordings

### From Statement Suggestions

Recordings can also be created from [statement suggestions](/projects/statements/assets/suggestions):

1. Upload royalty statements
2. Unmatched assets trigger Spotify search
3. Accept suggestions to create catalog items

## Editing Recordings

<Steps>
  <Step title="Open Recording">
    Click on the recording you want to edit.
  </Step>

  <Step title="Click Edit">
    Click the **Edit** button or click on individual fields.
  </Step>

  <Step title="Make Changes">
    Update the recording information.
  </Step>

  <Step title="Save">
    Changes are saved and history is tracked.
  </Step>
</Steps>

## Recording Relationships

### Linked Contracts

See all contracts that mention this recording:

* Master rights agreements
* Distribution deals
* Licensing agreements

### Linked Compositions

Connect recordings to their underlying compositions:

* One recording can have multiple compositions (medley, interpolation)
* One composition can have multiple recordings (covers, remixes)

### Products

Albums and releases containing this recording:

* Album title
* Release date
* Track position
* Source store (e.g., Spotify, Apple Music)

Products are sorted by type — albums first, then singles, then compilations. When a recording appears across multiple stores, all store names are shown together (e.g., "Spotify, Apple Music").

## ISRC Management

### What is an ISRC?

The ISRC is a 12-character code that uniquely identifies a recording:

```
US-S1Z-12-34567
│  │   │  │
│  │   │  └── Designation code (5 digits)
│  │   └───── Year of reference (2 digits)
│  └───────── Registrant code (3 chars)
└──────────── Country code (2 chars)
```

### Adding ISRCs

<Steps>
  <Step title="Find Your ISRC">
    Get the ISRC from your distributor, label, or ISRC agency.
  </Step>

  <Step title="Edit Recording">
    Open the recording and click edit.
  </Step>

  <Step title="Enter ISRC">
    Enter the 12-character code in the ISRC field.
  </Step>

  <Step title="Verify Format">
    The system validates ISRC format automatically.
  </Step>
</Steps>

### ISRC Lookup

Enable automatic ISRC lookup:

1. Connect your Spotify or Apple Music account
2. Match recordings by title and artist
3. ISRCs are populated automatically

## Statement Matching

Recordings are matched to royalty statements by:

1. **ISRC Match** - Exact ISRC match (most reliable)
2. **Title + Artist** - Fuzzy matching on metadata
3. **Manual Match** - User-defined matching rules

### Matching Status

| Status               | Description                         |
| -------------------- | ----------------------------------- |
| **Matched**          | Recording linked to statement lines |
| **Unmatched**        | No statement data found             |
| **Multiple Matches** | Possible duplicates, needs review   |
| **Suggested**        | AI suggests potential matches       |

## Best Practices

<AccordionGroup>
  <Accordion title="Always include ISRCs">
    ISRCs are essential for accurate statement matching and tracking.
  </Accordion>

  <Accordion title="Keep metadata consistent">
    Use consistent artist names and titles across your catalog.
  </Accordion>

  <Accordion title="Review duplicates">
    Regularly check for and merge duplicate recordings.
  </Accordion>

  <Accordion title="Link to contracts">
    Ensure recordings are linked to their governing contracts.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Compositions" icon="music" href="/projects/catalog/compositions">
    Learn about managing musical works and publishing data.
  </Card>

  <Card title="Edit Catalog" icon="pencil" href="/projects/contracts/contract-details/structured-data/edit-catalog">
    Add recordings to contracts via Spotify search.
  </Card>

  <Card title="Statement Suggestions" icon="wand-magic-sparkles" href="/projects/statements/assets/suggestions">
    Create recordings from unmatched statement assets.
  </Card>
</CardGroup>