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

# Compositions

> Manage musical works and publishing data in your catalog

## Overview

Compositions represent the underlying musical works - the song itself as created by the songwriter(s). While recordings are the specific audio, compositions are the intellectual property containing the melody, lyrics, and musical arrangement.

## Composition Information

### Core Fields

| Field                  | Description                      | Required    |
| ---------------------- | -------------------------------- | ----------- |
| **Title**              | Composition title                | Yes         |
| **ISWC**               | International Standard Work Code | Recommended |
| **Alternative Titles** | Other names for the work         | No          |
| **Language**           | Language of lyrics               | No          |

### Writer Information

| Field               | Description                         |
| ------------------- | ----------------------------------- |
| **Writers**         | Songwriters and composers           |
| **Writer Shares**   | Percentage ownership per writer     |
| **Writer IPI**      | Interested Party Information number |
| **PRO Affiliation** | Performance rights organization     |

### Publisher Information

| Field                | Description                   |
| -------------------- | ----------------------------- |
| **Publishers**       | Publishing companies          |
| **Publisher Shares** | Percentage controlled         |
| **Sub-Publishers**   | Territory-specific publishers |
| **Admin Rights**     | Administration details        |

## Viewing Compositions

### List View

The compositions list shows:

* Composition title
* Writers
* ISWC code
* Publishers
* Products (albums/singles/compilations with their source store)
* Linked recordings
* Statement earnings

### Filters

Filter compositions by:

* **Writer** - Songwriter name
* **Creator** - Who created the catalog entry
* **Matched** - Whether the composition is matched to statement data
* **Source** - Where the composition originated (contract or statement)
* **Match Type** - How the composition was matched (e.g. ISWC & ISRC, ISWC only, ISRC only, ISWC map, Album only)
* **Match Store** - The DSP store the match came from (e.g. Spotify, Apple Music, YouTube)

### Search

Search compositions by:

* Title (partial match)
* ISWC (exact match)
* Writer name
* Alternative title

## Composition Detail View

Click on any composition to see full details:

### Tabs

<Tabs>
  <Tab title="Overview">
    Basic composition information including title, ISWC, and language.
  </Tab>

  <Tab title="Writers">
    Complete writer split information with IPI numbers and PRO affiliations.
  </Tab>

  <Tab title="Publishers">
    Publisher data including shares and territory information.
  </Tab>

  <Tab title="Recordings">
    All recordings of this composition (originals, covers, versions).
  </Tab>

  <Tab title="Contracts">
    Publishing agreements covering this composition. 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="Statements">
    Performance and mechanical royalty data.
  </Tab>
</Tabs>

## Writer Splits

### Understanding Splits

Writer splits indicate ownership percentages:

```
Song: "Example Song"
├── Writer A: 50% (Lyrics)
├── Writer B: 25% (Music)
└── Writer C: 25% (Music)
Total: 100%
```

### Publisher/Writer Split

The typical split between publisher and writer:

```
Total: 100%
├── Publisher Share: 50%
│   └── Publisher A: 50%
└── Writer Share: 50%
    ├── Writer A: 25%
    └── Writer B: 25%
```

### Managing Splits

<Steps>
  <Step title="Open Composition">
    Navigate to the composition detail view.
  </Step>

  <Step title="Go to Writers Tab">
    Click on the Writers tab.
  </Step>

  <Step title="Add/Edit Writers">
    Add writers and enter their percentage shares.
  </Step>

  <Step title="Verify Total">
    Ensure shares add up to 100%.
  </Step>
</Steps>

<Warning>
  Writer shares must total exactly 100%. The system will warn you if shares don't add up correctly.
</Warning>

## Adding Compositions

### From Contract Extraction

Compositions are automatically added when publishing contracts mention them:

1. Upload a publishing agreement to Smart Drive
2. AI extracts composition references
3. Streaming platform data enriches metadata and links to recordings
4. Compositions appear in your catalog linked to the contract

### Manual Addition via Contract

To add compositions 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 compositions

### From Statement Suggestions

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

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

## ISWC Management

### What is an ISWC?

The ISWC is a unique identifier for musical works:

```
T-034.524.680-1
│ │         │
│ │         └── Check digit
│ └─────────── Work identifier (9 digits)
└───────────── Prefix (always T)
```

### Getting ISWCs

ISWCs are assigned by:

* Performance rights organizations (ASCAP, BMI, SESAC, PRS, etc.)
* ISWC registration agencies

### Adding ISWCs

<Steps>
  <Step title="Register Work">
    Register the composition with your PRO.
  </Step>

  <Step title="Obtain ISWC">
    Get the assigned ISWC from your PRO.
  </Step>

  <Step title="Update Composition">
    Enter the ISWC in Royaltyport.
  </Step>
</Steps>

## Recording Connections

### Linking Recordings

Connect compositions to their recordings:

<Steps>
  <Step title="Open Composition">
    Navigate to the composition.
  </Step>

  <Step title="Go to Recordings Tab">
    Click on the Recordings tab.
  </Step>

  <Step title="Add Recording">
    Search for and link recordings of this composition.
  </Step>
</Steps>

### Recording Types

| Type         | Description                        |
| ------------ | ---------------------------------- |
| **Original** | First recording of the composition |
| **Cover**    | Recording by a different artist    |
| **Remix**    | Modified version                   |
| **Live**     | Live performance recording         |
| **Sample**   | Used as a sample in another work   |

## Statement Matching

Compositions are matched to royalty statements by:

1. **ISWC Match** - Exact ISWC match
2. **Title + Writer** - Fuzzy matching on metadata
3. **PRO Work ID** - Society-specific identifiers
4. **Manual Match** - User-defined matching

### Revenue Types

Composition-related revenue includes:

* Performance royalties (radio, TV, streaming)
* Mechanical royalties (physical, downloads)
* Sync licensing fees
* Print music royalties

## Best Practices

<AccordionGroup>
  <Accordion title="Register works with PROs">
    Ensure all compositions are registered with relevant PROs to receive accurate statements.
  </Accordion>

  <Accordion title="Maintain accurate splits">
    Keep writer and publisher splits up to date as they may change with new deals.
  </Accordion>

  <Accordion title="Include alternative titles">
    Add all alternative titles to improve statement matching.
  </Accordion>

  <Accordion title="Link to recordings">
    Connect compositions to all known recordings for complete tracking.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Radar" icon="radar" href="/projects/catalog/radar">
    Learn how to monitor terms and territories across your catalog.
  </Card>

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

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