Imports & export
Bring tracks, albums, and collaborators into Aden from Spotify, SoundCloud, CSV, local audio files, or external uploaders; export financial data as CSV.
What it is
The import hub lets you pull your existing music catalogue into Aden without starting from scratch. Its sources are grouped by what they bring in: already released music comes from Spotify, SoundCloud, Songstats, or a CSV and lands in released status (no new-release fan notifications fire), while unreleased work comes from your files. A folder on your computer, Dropbox, or email attachments, and lands as private tracks you can keep building on. Once tracks are in Aden, all the usual tools. Versions, comments, collaborators, and distribution: work on them straight away.
There is also an export path: financial entries can be downloaded as a CSV at any time for accountants or reporting.
Using it
More than one account per platform
A team can connect several SoundCloud profiles (a main one plus an alias, a label with a profile per act) and carry several Spotify artist links. Every connected account shows as its own chip, Add another account sits in each chip's menu, and disconnecting one leaves the rest alone. The catalogues are merged into one table, deduplicated, so a release that sits on two of your profiles appears once.
One table for Spotify and SoundCloud
Tracks is every already-released catalogue in one list. Each row carries the platform it came from, and one Filters button holds Source, In Aden, Visibility and Playlist. The connected accounts sit at the other end of the same row: your Spotify artist page and your SoundCloud account, each shown with its picture and name, or a Connect button when it isn't set up yet. Import stays pinned to the right of every row however far you scroll sideways.
Fix it before you import it
Title, status, visibility, release date, genres and tags are editable in the table, with the same controls the track page uses: the status select carries your team's own status names and colours, visibility is the public/private select, and genres and tags are the tag fields from the track sidebar. Titles are plain inputs, and the release date is a date picker per row. None of it is saved on its own: the edits ride along with the import and become the values the track lands with, so a catalogue arrives the way you want it instead of needing 40 track pages afterwards. Clearing a release date imports the track without one.
Filters carries the same facets you think in on the tracks page: source, In Aden, visibility, status, genre, tags, credits, release year and playlist, each counted from the rows themselves. The search box also has the tracks page's AI mode: describe what you want ("soundcloud mashups not in Aden yet") and it sets those facets for you.
Notes opens the source description and the links inside it, which are the same links the importer sorts into streaming, presave and listen URLs.
Clicking a name in Credits adds that artist to the collaborator editor, so crediting the act and its songwriters happens in one place for hand-typed and imported tracks alike.
Dropbox, as a file tree
Local folder and Dropbox are one Files tab with a source switch:
same job, two places the files live. (The old ?tab=dropbox deep links still
land there, on the Dropbox source.)
The Dropbox source opens its account in a sheet from Browse Dropbox:
folders and files together, opening in place, with a checkbox on every audio
file and every folder, and a search box over the whole account (Dropbox's own
search_v2, files and folders, each result showing the folder it lives in).
Ticking a folder ticks every audio file under it however deep, opened or not:
the server walks it in one call. Review N files reads the folder they
share, closes the sheet and fills the table; a folder you haven't opened has
its own Review folder. Nothing in the sheet transfers anything, so there is
one Import button on the page, in the table, where the review is. Artwork and
other files are listed too, greyed out, so a folder never looks empty when it
isn't.
Files you have already brought across are marked In Aden, matched on the Dropbox content hash the importer dedupes on, so a second pass over the same folder shows you what is new rather than offering you your own catalogue again. They are left out of the default selection and can be hidden entirely from the review table.
Transfers report in the app's upload panel, one row per track, the same panel file uploads use.
What comes back is the same editable table as the catalogue imports. The
filename runs through the same extractors the track create form uses, so
Mave X Daevo A Place We Both Know RADIO MIX lands as the title
"A Place We Both Know", the artists Mave and Daevo, and a version tag, all
editable before anything is written. Status, visibility, genres and tags are
per row here too, and opening a row shows the files behind it (mp3, wav, the
version each becomes).
Albums and playlists
Albums is the same table for releases: open a row to see its tracklist, with the tracks you already have marked, and hide a release that isn't yours the same way you hide a track. Singles Spotify files as their own one-track album appear here too, rather than behind a separate accordion. SoundCloud sets have their own Playlists tab.
What is already in Aden
Every row says whether you already have the track, in the In Aden column
and the Status filter. Matching does not need the titles to be identical:
an ISRC wins outright, and past that a run-together upload name
(staywithme-jum), an artist prefix (Mave x Appys - Stay With Me), a
remaster suffix (bodymove..._REMASTER2026) or a bracketed tracklist all still
find the track they belong to.
Only a near-certain match counts as Already in Aden, and those rows cannot be selected. Anything looser is a Possible match: the row stays importable, names the track it resembles, and the review step repeats the warning, so an extended mix or a remix of something you have is your call rather than ours.
Who gets credited, and genres and tags
Collaborators in the toolbar is the same editor as the track create form: add people you have worked with, credit an artist team, or type a name for someone who isn't on Aden yet, with roles, IPI and splits per person. Everyone here is credited on every track any import creates, on top of the artists read from the source, and the review step shows the line-up before anything is written.
The same panel sets genres and tags applied to every imported track (Spotify, SoundCloud, Songstats, Dropbox, local folder), so a 200-track migration lands pre-organised instead of needing a tag pass afterwards, plus the songwriter-enrichment toggle.
Visibility of what you import
The same panel also holds Publish imported releases on your public page, on by default. Spotify, Songstats and SoundCloud tracks are already out in the world, so importing them hidden leaves your public page empty until you flip every row by hand. Turn it off to keep a migration private until you have reviewed it. Two things it never overrides: a private or unlisted SoundCloud upload stays private, and files you upload (folder, Dropbox, email) always land private.
Importing from Spotify or SoundCloud
- Go to your team's Import page (
/app/teams/[teamId]/import). - If your team has a Spotify or Deezer link set under team settings, Aden fetches your catalogue automatically and shows which tracks already exist and which are new.
- Tick the tracks you want and click Review, or use a row's own Import button for a single track. Either way the review step opens first: it shows the title, status, credits and tags each track will land with, who is credited on all of them, and lets you edit or drop any of it before writing.
- Tracks land in your team's catalogue in
ideastatus (orreleasedif the original has a release date). The release's cover art comes with them: Aden downloads the artwork from Spotify, stores it in your team's storage, and sets it as the track's or album's cover, so imported music shows its artwork everywhere straight away.
If a track or album you already have is missing its cover, the duplicate row on the import page offers an Artwork update. Tick it and click update to pull the cover in without touching the rest of the record. Covers you have already set are never overwritten.
If the fetched catalogue contains music that isn't yours (a wrong artist
match, someone else's remix), hide it: the eye-off button on any row, or
select several tracks and choose Hide in the action bar. Hidden items are
stored per team (teams.hidden_import_ids) and filtered out of every future
import fetch, so they never show up again.
Already-released music imports directly into released status, and the
release-time automations (lifetime-fans auto-save, release emails) only fire
on a status transition into a release state, which imports never make. So
importing a decade of releases never emails your lifetime fans or auto-saves
anything to their Spotify libraries. Imported tracks still get the full
toolset, royalties, rights deals, sync licensing, and you can run a
revival plan on any released track to make it relevant again (see the
Releases feature).
The header shows the Spotify (or Deezer) artist page the import reads from: click it to open that page, or use the pencil next to it to point the import at a different artist URL. It is the same link as the Spotify entry under team links, so changing it in either place updates both.
Collaborators added to an import carry splits for every revenue type. The Splits column takes one percentage that applies to all of them; the gear next to it opens the per-type editor (publishing, royalty, mechanical, sync, composition, master).
For SoundCloud, click Connect SoundCloud on the Import page and sign in. Because you are signing in to your own account, Aden sees everything on it: private and unreleased tracks come across too, marked with a Private badge. Any SoundCloud account works, no Artist Pro needed.
Public tracks land as released; private ones land in progress, since that half of a SoundCloud account is the working catalogue (mashups, edits, bootlegs, unfinished ideas). If a title carries its own marker ("[WIP]", "v2") that wins over both.
The description comes across too, and the links in it are sorted into the fields that already exist: Spotify/Apple/Deezer/Tidal/Amazon/YouTube links become streaming links, a presave or hyperfollow link becomes the presave URL, and a smart link or download gate (ffm.to, linktr.ee, Hypeddit, ToneDen) becomes the listen URL. The full text is kept as the track description, so anything not recognised is still there. Rows show a link badge with the count before you import.
Tracks you already have are marked Already in tracks and the badge opens the track in Aden, so you can check before importing again.
The Playlist filter on the Tracks tab turns any SoundCloud set into a bulk selection: pick a mashup pack, tick all, review, import. Only your own uploads are offered: a set holds whatever its owner put in it, and a chart or a mashup pack full of other artists' tracks is not your catalogue. Sets label the rows they contain (the Playlists column shows which sets a track sits on) rather than adding rows of their own. That is the tracks-only path; the Playlists tab is for when you also want the set recreated as an Aden playlist.
Nothing is written until you confirm. Review opens a last overview of every selected track: what it will be called, its tags, the artists it will credit and whether it lands released or in progress. Titles and credits are editable there, tags can be added per track (with suggestions) or removed, your page-wide default tags arrive pre-filled on every row, and any track can be dropped from the batch.
Dates come across as they are on SoundCloud: a track's created date is the day it went up there, not the day you imported it, so a catalogue sorted by "recently added" still reads as your actual timeline. Private tracks get no release date at all, since an unreleased idea has not been released.
Audio stays on SoundCloud. Imported tracks carry their title, artwork, genre, duration and release date, and link back to the sound on SoundCloud. If you want the master file in Aden as well, upload it from the Local files tab.
Importing your Songstats catalogue (every platform at once)
The Songstats tab on the Import page pulls your whole catalogue in one go not just what a single store knows about you. It needs a Songstats, Spotify or Deezer artist URL in your team links.
Hit Load catalog and you get every track Songstats has for you, across Spotify, Apple Music, Deezer, Tidal, Amazon, SoundCloud and YouTube, with each platform's ID and URL attached. Nothing is imported until you pick tracks and press Import.
Two things worth knowing:
- Your unofficial releases come too. Remixes, edits, flips and bootlegs that only ever went up on SoundCloud or YouTube, no store release, no ISRC, are part of the catalogue and are listed with an Unofficial badge. Use the All / Official / Unofficial switch to narrow the list.
- Tracks you already have are marked, not re-imported. Matching is by ISRC first, then exact title.
Importing from a CSV
- On the Import page, switch to the CSV tab.
- Download the template (title, ISRC, UPC, EAN, ISWC, artist, label, genre, subgenre, language, duration, release date, year, description, explicit, catalog number).
- Fill in your rows and upload the file.
- Optionally assign collaborators to all imported tracks in one step.
- Click Import tracks: results show how many succeeded and any rows that failed with an error.
You can also tick Discover songwriters via ISRC to have Aden look up publishing metadata for any track that has an ISRC and pre-fill collaborators.
Uploading local audio files
- On the Import page, open the Local files tab.
- Drag audio files (MP3, WAV, FLAC, …) from your computer onto the dropzone. Each file can be mapped to create a new track, add a new version to an existing track, replace the primary audio file of a version, or attach an extra format to a version.
- Files are uploaded to R2 under a
pending/prefix first, then claimed into the track on confirm. - MP3 uploads work on any plan; non-MP3 formats require the Pro plan or higher.
Finding one track's file on your computer
The Import page's Local files tab matches a whole folder against your whole
catalogue. When you already know the track, do it from the track page instead:
open a track with no version and click Find on my computer inside the
dropzone. Pick a folder and Aden ranks its audio files against that one title,
pre-ticking likely matches; confirming adds them as versions of that track. It
shares the folder-scanning and title-matching code with the Local files tab
(apps/web/lib/utils/local-audio-files.ts,
apps/web/lib/utils/local-file-duplicate-detection.ts), but skips the
new-track/replace/attach targeting: everything lands as a new version of the
track you're on.
Right after creating your team
Finishing onboarding lands you on the Import page in a first-run view: two cards ask whether you want to bring in your released catalogue (from Spotify/SoundCloud, with titles, artwork, and release dates) or your unreleased and in-progress tracks (pick a folder on your computer. Each audio file becomes a private track titled after its file name). If the wizard already imported your released catalogue, you land straight on the folder side. Continue to workspace exits to your team and starts the tour.
Sharing an upload link with someone outside your team
You can create a shareable upload link so that a photographer, label contact, or anyone else can drop files into your team without needing an Aden account.
- Go to team settings and create an Upload link.
- Set an optional title, expiry date, and usage limit.
- Copy the link and send it. The recipient sees a simple upload page, no login required.
- Uploaded files land in the team's (or track's / album's) media gallery or documents area depending on how you configured the link.
Exporting financial data
From the Financials page, click Export to download all income and expense entries as a CSV file. You can filter by date range before exporting. The file includes ID, type, amount, currency, category, description, date, invoice ID, linked track/album, and who recorded the entry.