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
- 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:Tracks already linked to this contract are shown as disabled and cannot be selected again.
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.
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 Contract Period” or “First Option Period”) 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
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 individual track or composition in a group with at least one other group available:
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.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