If your import is failing or your files are not being accepted, follow the steps below in order. Most import issues are caused by one of these: the wrong account is connected, the files were changed, the files were already used on another account, or the uploader is struggling with a large ZIP file.
Before you import
To import your listening history:
- You must have an active stats.fm Plus/Pro subscription
-
You must be connected to the matching service inside stats.fm before importing:
- Spotify for Spotify files
- Apple Music (with an active Apple Music subscription) for Apple Music files
You can check your connections by going to Settings → Connections in the mobile app.
- Your files must be original and untouched:
- Do not rename them
- Do not edit them
- Do not move or change their contents
- Do not reuse files that were already imported on another stats.fm account
If everything above is correct and your import still fails, try the options below.
Option 1: Import via web instead of the app
If importing in the mobile app doesn't work, try importing on the web instead. Go to stats.fm/import, log in to the same stats.fm account, and upload your files there.
Option 2: Upload files individually instead of as a ZIP
ZIP imports usually work, but in some cases they may fail — especially when the dataset is large.
If that happens:
- Extract or unzip the downloaded archive
- Locate the original files inside
- Upload the import files one by one instead of uploading the full ZIP at once
This is especially worth trying if the upload stalls, fails immediately, or never finishes processing. You can learn how to extract .zip files on this page.
Important file rules
Make sure your files meet all of these requirements:
- They must come directly from Spotify or Apple
- You must select the right types of files:
- Spotify: ZIP or JSON (if you unzipped the downloaded archive)
- Apple Music: ZIP or CSV (if you unzipped the downloaded archive)
- Select no more than one ZIP file in one selection
- Do not combine ZIP and other files in the same selection
- Files must not be renamed, edited, or modified in any way
- They must not have been used on a different stats.fm account before
If any of the above isn't true, the import may fail or be rejected.
"There are no valid files in what I uploaded"
This usually means you received the wrong data package from Spotify (Spotify offers three different data packages, and only one of them contains the right files for stats.fm). See the Import FAQ for details on the three Spotify data packages and how to request the right one.
Last steps if nothing works
If the import still doesn't work:
- Request a new copy of your data from Spotify or Apple Music
- Download the new files
- Try the import again from scratch — first on the web, and if needed, unzip the files and upload them one by one
Still not working?
Submit a ticket under the "I'm having trouble importing my data" category and include:
- The file you tried importing
- A screen recording showing where you're importing from, the file you selected, what happens after you press upload, and any error message that appears
The more detail you can include, the faster we can figure out what's going wrong.