Import from CSV – How does it work?

Import from CSV – How does it work?

What is CSV Import?
Crates allows you to import your tunes and playlists from many different music services using a CSV file. This is the easiest way to bring your music collection into Crates, especially if you use platforms that are not directly integrated.

How do I export my library as a CSV?
We recommend using TuneMyMusic — a third-party service that supports backup and export from Spotify, TIDAL, SoundCloud, YouTube Music, Apple Music, Deezer, Qobuz, Beatport, and more.

1. Go to TuneMyMusic Backup
2. Choose “Backup to a file”
3. Select your source platform (Spotify, Apple Music, Deezer, TIDAL, SoundCloud, etc.)
4. Download your library as a CSV file
5. In Crates, go to Library → Import from CSV and upload your file

What fields are supported in the CSV?
Crates will automatically detect and import any CSV that contains the following fields/columns (case-insensitive):

• Track name (required)
• Artist name (required)
• Album
• Playlist name (the playlist this track belongs to, if any)
• Type (e.g. Track, Album, Playlist, Favorite)
• ISRC (International Standard Recording Code, if available)
• Platform ID columns:
  One or more columns like Spotify – id, Tidal – id, Soundcloud – id, YouTube Music – id, etc.
• Other supported platforms include: Apple Music, Deezer, Qobuz, Napster, Beatport, Beatsource, Yandex Music, Pandora, KKBOX, Soundmachine, Boomplay

Any CSV that includes at least “Track name”, “Artist name”, and a platform ID column (e.g. “Spotify – id”) will work!

How does the import logic work?

• Tunes and Playlists:
  • Crates imports each track from the CSV, placing it in the appropriate playlist or collection.
  • If the track is marked as a favorite or has no playlist, it goes directly under the selected collection.
  • If the track is part of an album or playlist, Crates will automatically create a new playlist (or update an existing one) under your chosen folder, using the playlist/album name.
• Supported Types:
  • Tracks and playlists are supported.
  • If a row is marked as “artist” type, it is skipped (importing artists only is not currently supported).
  • Unknown types will be added to your main collection.
• Platform Compatibility: Crates supports CSVs exported from any service listed in TuneMyMusic, as long as the required fields are present.

Can I import any CSV?
Yes! You can import any CSV file (even if you didn’t use TuneMyMusic) as long as it matches the column structure above—especially “Track name”, “Artist name”, and at least one *- id column such as “Spotify – id” or “Tidal – id”.

What happens after import?

• Tracks and playlists will appear in your Crates library, under the collections and playlist folders you select.
• For some platforms (like SoundCloud), Crates will attempt to fetch extra track info if you’re connected with that service.
• If a field is missing (e.g. no ISRC), the import still works – Crates will use whatever data is present.

Example of supported CSV columns:

Need help?
If you have trouble importing your CSV or have questions about the process, please contact support.