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

# Edit Catalog

> How to manually add and edit recordings and compositions on a contract

## Overview

While the AI extraction captures most assets from the contract, you may need to manually add or edit recordings and compositions -- for example, when assets are referenced indirectly, when new releases are delivered after extraction, or when linking back-catalog items.

## Adding Recordings

<Steps>
  <Step title="Open the edit dialog">
    On the contract detail page, navigate to the **Catalog** section under the Details tab. Click the **edit icon** (pencil) on the Recordings section.
  </Step>

  <Step title="Click + Recordings">
    In the recordings manager, click the **+ Recordings** button to open the multi-step wizard.
  </Step>

  <Step title="Enter details and search">
    Fill in the search fields:

    * **Name** -- enter a track name, single name, album name, or compilation name
    * **Artists** -- enter artist names, separated by commas for multiple artists

    You can also configure search options:

    * **Search Spotify** -- toggle on (default) to search Spotify for matching releases. Toggle off to skip and add the recording without product data.
    * **Proxy** -- enable proxy search to access region-specific Spotify content (e.g., releases only available in Japan or Germany). Select the target country from the dropdown.
  </Step>

  <Step title="Browse and select results">
    Search results are organized into four tabs for easy browsing:

    | Tab              | Shows                    |
    | ---------------- | ------------------------ |
    | **Tracks**       | Individual track matches |
    | **Singles**      | Single releases          |
    | **Albums**       | Album releases           |
    | **Compilations** | Compilation appearances  |

    From the **Tracks** tab, select individual tracks. From the **Singles**, **Albums**, or **Compilations** tabs, click an album to load its tracklist, then select the tracks you want. You can sort results.

    Each tab has a **Select All** button. On the album-style tabs, Select All fetches every product's tracks and selects them in bulk; products picked up this way are highlighted with a **Selected** badge.

    <Note>
      Because Spotify limits how many requests we can make in quick succession, selecting all on a tab with more than a few products opens a confirmation dialog warning that the operation may take a moment. The tracks are fetched one product at a time to stay within the rate limit.
    </Note>

    Tracks already linked to this contract are shown as disabled and cannot be selected again.
  </Step>

  <Step title="Select derivative tracks">
    If the contract includes derivative works for this recording, toggle **Search for derivative works** to find remixes, acoustic versions, live recordings, and other variants. Review and select the ones that apply.
  </Step>

  <Step title="Link to commitments">
    Optionally link the recording to a contract commitment (e.g., "Initial Album Commitment") to track delivery progress. Commitment links affect how [calculated end dates](/projects/contracts/contract-details/structured-data/dates#commitment-scoped-end-dates) are scoped — each commitment can produce its own end dates for its linked assets.
  </Step>

  <Step title="Preview and organize groups">
    The preview step proposes how the new recordings will be organized into asset groups — see [Organizing groups in Preview](#organizing-groups-in-preview) for how to rename, move tracks, change group type, or add and remove groups before confirming.
  </Step>

  <Step title="Confirm">
    Click **Confirm** to save the recordings to the contract. The Update button at the bottom of the Edit Contract sheet then persists all pending changes.
  </Step>
</Steps>

## Adding Compositions

<Steps>
  <Step title="Open the edit dialog">
    On the contract detail page, navigate to the **Catalog** section under the Details tab. Click the **edit icon** (pencil) on the Compositions section.
  </Step>

  <Step title="Click + Compositions">
    In the compositions manager, click the **+ Compositions** button to open the wizard.
  </Step>

  <Step title="Enter details and search">
    Fill in the search fields:

    * **Name** -- enter the composition or track name
    * **Writers** -- enter writer names, separated by commas

    The same search and proxy options are available as for recordings.
  </Step>

  <Step title="Browse and select results">
    Results are organized into the same four tabs (Tracks, Singles, Albums, Compilations). Select the tracks that are recordings of this composition.

    <Note>
      When **Search Spotify** is on, each selected track creates a separate composition entry named after that track, grouped by album — the same way recordings are handled. If you select tracks from multiple albums, the compositions are split into separate album groups automatically.

      When **Search Spotify** is off (manual entry), a single composition is created using the name you entered.
    </Note>
  </Step>

  <Step title="Select derivative tracks">
    If applicable, review and select derivative versions found during the search.
  </Step>

  <Step title="Link to commitments">
    Optionally link the composition to a contract commitment. Commitment links affect how [calculated end dates](/projects/contracts/contract-details/structured-data/dates#commitment-scoped-end-dates) are scoped — each commitment can produce its own end dates for its linked assets.
  </Step>

  <Step title="Preview and organize groups">
    The preview step proposes how new compositions will be organized into asset groups — see [Organizing groups in Preview](#organizing-groups-in-preview) for how to rename, move compositions, change group type, or add and remove groups before confirming.
  </Step>

  <Step title="Confirm">
    Click **Confirm** to save the compositions to the contract. The Update button at the bottom of the Edit Contract sheet then persists all pending changes.
  </Step>
</Steps>

## Organizing groups in Preview

Before confirming, the Preview step lets you organize the new recordings or compositions into **groups**. Royaltyport seeds the groups for you — matching new items into existing groups when titles align, and creating new groups for the remainder — and you can adjust them from there.

<Note>
  Groups are decorative — a way to organize how you view assets on the contract. They don't change how Royaltyport uses the assets linked to this contract.
</Note>

For each new group you can:

| Action          | How                                                                     |
| --------------- | ----------------------------------------------------------------------- |
| **Rename**      | Edit the title inline in the group header                               |
| **Change type** | Pick **Album** or **Asset** from the type dropdown next to the title    |
| **Delete**      | Click the trash icon on the group header (only available on new groups) |

For each individual track or composition in a group with at least one other group available:

| Action                    | How                                                                                                                          |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Drag to another group** | Use the grip handle on the left and drop the item into another group                                                         |
| **Move via menu**         | Click the shuffle icon on the right and pick a destination group, or **+ Group** to break it out into a new group of its own |

To add a new empty group, click the **+ Group** button at the top of the Groups section. Items moved into an existing group are added to that group on save; items in a new group create a new asset group when you confirm.

Items already linked to the contract are shown above the Groups section and cannot be regrouped — they're displayed for reference only.

## Proxy Search

Some recordings are only available on Spotify in specific regions (e.g., a Japanese bonus track or a territory-specific release). Enable the **Proxy** option in step 1 and select the target country to route the search through that region's Spotify catalog.

<Tip>
  If the contract specifies restricted streaming territories for certain assets, try enabling proxy with the relevant country to find region-locked releases.
</Tip>

## Deduplication

When adding catalog items, the system automatically checks for duplicates:

* **Recordings** are deduplicated by title and duration -- if a recording with the same name and length already exists in your project, the existing record is linked rather than creating a duplicate.
* **Compositions** are deduplicated by title and writer combination -- ensuring each unique work appears only once in your catalog.

## Editing Existing Items

To edit an existing recording or composition, open the edit dialog from the Catalog section. You can:

* Update metadata (title, artists, identifiers)
* Add or remove Spotify product links
* Change commitment associations
* Toggle derivative inclusion