---
title: "Import works from release links"
description: "Paste Spotify, Deezer or Beatport links to your releases, or ISRCs, and review the recordings they give as works before anything is saved."
image: "https://trackforge.studio/docs/img/trackforge-social-card.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://trackforge.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import works from release links

Use this page to bring the recordings on your releases into a catalogue from their links. The Workspace reads each recording, puts the recordings of one title by one artist on one work, and shows the result for you to review. Nothing reaches your catalogue until you save, as [Review an import before saving](/docs/workspace/add-works/review) explains.

## Before you start

- You need to be able to edit the workspace. With view-only access the import button is not there.
- Open the catalogue the works should go into. [Several catalogues](/docs/workspace/catalogue/several-catalogues) shows how to make a new one.
- Links give recordings, not writers. A work made from a link has no writers, shares or control, so the review shows it as needing information, which is its normal state. Once saved, the work's page suggests any writers our sources hold; add shares and whether you control each work yourself. A new release often has none anywhere yet.

## Steps

1. Go to **Catalogue** and choose **Import a file (CSV, TSV, Excel or CWR)**. The **Import works** panel opens.
2. Under **What are you importing?**, choose **Spotify, Deezer or Beatport links to your releases**.
3. Paste your links or ISRCs into **Release links or ISRCs**, one to a line. Or use **Or choose a CSV or text file of links** to choose a CSV, TSV or text file with the links in any column.
4. Choose **Look up and review**. While the recordings are read, the screen says **Looking up each recording. An album can take up to a minute.** The review then opens on the works themselves. There are no columns to match.

## What you can paste

Each line, or each cell of a file, is read on its own, so a title or an artist beside a link is passed over. The Workspace reads:

- Spotify links to a track or an album, such as open.spotify.com/track/… or open.spotify.com/album/…, in any language version of the address. A Spotify URI (spotify:track:…) is read too.
- Deezer links to a track or an album, such as www.deezer.com/en/album/….
- Beatport links to a track or a release, such as www.beatport.com/track/…/12345 or www.beatport.com/release/…/12345.
- ISRCs, with or without hyphens.

Paste up to 100 links or ISRCs at a time. A longer list is refused before anything is read, with the message "Paste up to 100 links or ISRCs at a time. Split the list and add the rest as a second import." A link or ISRC pasted twice is read once.

Any other line is listed back with what to paste instead, and never becomes a work:

- A short share link, such as spotify.link or deezer.page.link: "A short share link does not say which track it is. Open it, then copy the address from the browser and paste that."
- A playlist, artist, label or podcast link: "Playlist, artist, label and podcast links are not releases. Paste the links of the tracks or releases instead."
- A link to any other site: "Only Spotify, Deezer and Beatport links are read so far."
- A Spotify, Deezer or Beatport link with part of its address missing: "This Spotify link is not complete."

Up to 50 such lines are listed. Any more are counted: "3 more lines were not a link or an ISRC."

## What a link gives

A track link gives one recording. An album or release link gives one recording for each of its tracks. Each recording carries what the service gives: its ISRC, title, artist and duration, and its release's album title, release date, barcode and label. Every detail is read from the service the link names, so a Deezer link is never sent to Spotify. The work's title is the recording's title without a version suffix, so a track called "Song - 2011 Remaster" becomes the work Song, and the recording keeps its own track title.

The recordings of one title by one artist go on one work: an album's remaster and its extended mix, or the same song on two pasted albums. The review says so under the work: "The 2 recordings of this title by this artist are put on one work. If one is a different song, remove it from the work after saving." A work row holds up to ten recordings; the rest go on the next row, with a note to move them onto one work after saving. A recording that is already on a saved work is offered as a match to that work, and is never saved over it.

**Spotify.** A Spotify link is read first from TrackForge's copy of Spotify, taken in July 2025. A track or album the copy does not hold is asked of Spotify itself. For an album asked of Spotify, each track's ISRC is read from Deezer's copy of the same release. A track Deezer's release does not match is left out and counted: "2 of this album's 12 tracks gave no ISRC: neither our copy of Spotify nor Deezer's copy of this release has them. Paste each track's Deezer link or its ISRC to add them." The label comes from the copy, or from Deezer's or Discogs's release with the same barcode. Failing those it is read from the ℗ line on Spotify, and the recording says "The label is read from Spotify's P-line: check it."

**Deezer.** A Deezer link is asked of Deezer. An album gives one recording for each track Deezer holds an ISRC for. The rest are counted in a note, with "Paste the album link again as a second import to add them."

**Beatport.** A Beatport link is read only from TrackForge's copy of Beatport, which ends on 19 September 2023. Beatport itself is never asked. A track link gives that track. A release link gives one recording for each track with an ISRC, and the rest are named: "3 of this release's 10 tracks have no ISRC on Beatport, so they were not added. Paste each one's ISRC, or add it by hand." Beatport's mix name, such as Original Mix or a remix, is shown with the track title and is never put in the work's title. Beatport gives no barcode, so the label is Beatport's own. A track or release the copy does not hold is named: "Our copy of Beatport, which ends on 19 September 2023, has no track or release at this link. For a newer release, paste its Spotify or Deezer link or its ISRCs instead; otherwise check the link is complete."

**ISRCs.** An ISRC gives the recording's own details, from our copy of Spotify or else from Deezer: its title, artist and duration. An ISRC can be on several releases, so its album, label, barcode and release date are left to the [fill from our sources](/docs/workspace/add-works/review#release-details-filled-in-from-our-sources), which takes them from the earliest release our sources hold. Paste the release's link to use that release instead. An ISRC found nowhere is named: "Not found yet on Deezer or in our copy of Spotify. A new release can take a few days to appear: try again later, or add the recording by hand."

## Where each detail came from

Above the works, **Where these details came from** says how many recordings were read, from which services, and on what day. Under each work, every recording is listed with its ISRC and title, then each service that gave a detail, the date it was read or the month of our copy, and the details it gave.

A detail from Spotify carries Spotify's logo, which opens the recording on Spotify. Details from Deezer, Beatport and Discogs link back by the service's name, with no logo.

If your workspace has a label rule, a label a service gives is written as the rule says, and the recording keeps a note of the label the service gave.

## A link that cannot be read

Each link is read on its own, so one that fails never stops the rest. The links and ISRCs that gave no recording are listed under a notice that counts them, each with what to do:

- The service has nothing at the link: "Spotify has no track or album at this link. Check the link is complete." Deezer's message is the same.
- The service cannot be asked: "Spotify isn't answering us today. Paste the Deezer link or the ISRC instead." For Deezer, "Deezer could not be asked just now. Try again in a few minutes." For Beatport, "Our copy of Beatport could not be read just now. Try again in a few minutes, or paste the recordings' ISRCs instead."
- The lookup ran out of time: "Not read in time. Paste this link again as a second import." For an album whose later tracks were not read, the note says how many and asks for the album link again as a second import.
- The service's answer could not be read: "The service's answer for this link could not be read. Try again later, or add the recording by hand."

A link that gave no recording is never saved as a blank work. The list stays with the import under **Where these details came from**.

## If something goes wrong

- **Look up and review** is switched off. The box is empty.
- "This file is too long to read as links. Choose a file of up to 100 links, or paste them." Split the file, or paste the links.
- "This file is empty. Choose a file with your links in it, or paste them."
- The same song is in the review twice. Its recordings carry different titles or artists on the services, so they were put on two works. Save both, add the second work's recordings to the first and delete the second: see [One work, several ISRCs](/docs/workspace/catalogue/recordings#one-work-several-isrcs).

## Related

- [Review an import before saving](/docs/workspace/add-works/review)
- [Recordings](/docs/workspace/catalogue/recordings)
- [Ways to add works](/docs/workspace/add-works/)

Source: https://trackforge.studio/docs/workspace/add-works/release-links/index.mdx
