Skip to main content

Spotify Import Guide

stats.fm Support
  • Updated

Importing your Spotify streaming history requires stats.fm Plus.

1. Request your data from Spotify

To request your extended streaming history files:

  1. On mobile, go to Settings > Privacy and social, scroll down and click on View more options to open the Privacy page (on website, you can access their Privacy page directly from the previous link)

  2. Scroll down, untick "Account data" and tick "Extended streaming history." Then press the "Request data" button

Make sure you only tick "Extended streaming history" — the other two packages (Account data and Technical log information) don't contain the files stats.fm needs. If you tick the wrong box, you'll have to request the right package separately, which adds 2-3 weeks of waiting.

2. Confirm your request

Spotify will send you an email with a button to confirm your request. Click it — once you do, Spotify will start gathering your data.

After you've clicked on the Request data button, Spotify will start gathering your data. You'll get a confirmation email then, too.
 

3. Turn on Sync streams to avoid gaps

While you're waiting for Spotify to prepare your data (which can take up to 30 days, usually 2-3 weeks), enable sync in the stats.fm app so new streams keep being tracked in the meantime.

In the app, go to Settings → Connections → Sync streams and make sure it's turned on. This way, anything you listen to during the wait period gets captured automatically, and your imported history will be complete when you upload the file.

4. Wait for your data

This can take a while. Spotify states it shouldn't take longer than 30 days, though the actual wait is usually 2-3 weeks. You'll get an email when your data is ready.

5. Download the files

When your data is ready, you'll get a second email with a link to download a .zip file containing your streaming history.

Never share your data files with others. They may contain personal information, depending on what Spotify included.

6. Import your files

You have two options for uploading: directly in the app on mobile or through the stats.fm web import page.

App import (mobile)

  1. Open the stats.fm app

  2. Go to Settings > Import files

  3. Choose Spotify

  4. You'll see a pop-up. Click on Choose

  5. Select the Spotify file with your data

Web import

  1. Go to stats.fm/import and make sure you're logged in
  2. Drag and drop your files into the upload area, or click to open a file picker
  3. Select the .json files from your downloaded data
  4. Press the Upload button in the top right

Your files will be processed, which can take anywhere from a few seconds to a couple of hours depending on how many streams you have. You can close the tab while it processes — you'll get a notification in the stats.fm app for each file when it's done.

If you don't see any importable files, you may have downloaded the wrong package — see the Import FAQ for details on the three Spotify data packages and how to get the right one.

If a file import fails, try uploading the errored file again. If it still doesn't work, see our import troubleshooting guide.

7. You're done

You can now view your full listening history, exact play counts, and the deeper stats that come with imported data. Your future streams will keep syncing automatically.

Related articles