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

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

2. Click + Recordings

   In the recordings manager, click the + Recordings button to open the multi-step wizard.

3. 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.
4. 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.

   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.

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

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

6. 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 are scoped — each commitment can produce its own end dates for its linked assets.

7. Preview and organize groups

   The preview step proposes how the new recordings will be organized into asset groups — see Organizing groups in Preview for how to rename, move tracks, change group type, or add and remove groups before confirming.

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

Adding Compositions

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

2. Click + Compositions

   In the compositions manager, click the + Compositions button to open the wizard.

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

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

   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.

5. Select derivative tracks

   If applicable, review and select derivative versions found during the search.

6. Link to commitments

   Optionally link the composition to a contract commitment. Commitment links affect how calculated end dates are scoped — each commitment can produce its own end dates for its linked assets.

7. Preview and organize groups

   The preview step proposes how new compositions will be organized into asset groups — see Organizing groups in Preview for how to rename, move compositions, change group type, or add and remove groups before confirming.

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

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.

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.

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.

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

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