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
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.
Click + Recordings
In the recordings manager, click the + Recordings button to open the multi-step wizard.
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.
Browse and select results
Search results are organized into four tabs for easy browsing:
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 and use select/deselect all.Tracks already linked to this contract are shown as disabled and cannot be selected again.
| Tab | Shows |
|---|---|
| Tracks | Individual track matches |
| Singles | Single releases |
| Albums | Album releases |
| Compilations | Compilation appearances |
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.
Link to commitments
Optionally link the recording to a contract commitment (e.g., “Initial Album Commitment”) to track delivery progress.
Adding Compositions
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.
Click + Compositions
In the compositions manager, click the + Compositions button to open the wizard.
Enter details and search
Fill in the search fields:
- Name — enter the composition or track name
- Writers — enter writer names, separated by commas
Browse and select results
Results are organized into the same four tabs (Tracks, Singles, Albums, Compilations). Select the recordings of this composition and their product appearances.
Select derivative tracks
If applicable, review and select derivative versions found during the search.
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