Export your Goodreads data and import it into StoryGraph in three steps

You can move your entire Goodreads library — all your books, ratings, and reading status — to StoryGraph by exporting a file from Goodreads and uploading it to StoryGraph. The process takes about ten minutes and requires no special software. Goodreads exports as a CSV file (a spreadsheet format), and StoryGraph reads that file directly.

The main limitation: Goodreads exports your shelf names, book titles, ratings, and dates read, but not your written reviews. If you have reviews you want to keep, you will need to save those separately before you export. StoryGraph can import reviews from other sources, but not directly from a Goodreads export.

Key Takeaways

  • Export your Goodreads library by going to your account settings, selecting "Import and Export," and downloading your books as a CSV file.
  • StoryGraph accepts the Goodreads CSV file directly — you do not need to edit or convert it before uploading.
  • Your ratings, reading status, and shelf names transfer over, but written reviews do not come through in the export.
  • If you have reviews you want to preserve, copy them to a document or note-taking app before you export, since the CSV file does not include review text.

Step 1: read your Goodreads library as a CSV file

Log into your Goodreads account and go to your profile page. Click the menu icon (three horizontal lines) in the top left corner, then select "Settings." Scroll down until you see "Import and Export" — this is usually near the bottom of the page.

Click "Export Library." Goodreads will generate a CSV file containing all your books, ratings, shelf assignments, and dates read. The file will read to your computer's default read folder. It will be named something like "goodreads_library_export.csv." Do not edit this file — StoryGraph reads it as-is.

Step 2: Create or log into your StoryGraph account

Go to StoryGraph's website and create a free account if you do not already have one. You will need an email address and a password. Once you are logged in, go to your account settings by clicking your profile icon in the top right corner and selecting "Settings."

Look for an "Import" or "Import Books" option. StoryGraph usually places this in the left sidebar under "Your Books" or in the main settings menu. Click it to open the import tool.

Step 3: Upload your Goodreads CSV file to StoryGraph

In the import tool, you will see an option to select a file. Click "Choose File" or "Upload File" and navigate to the CSV file you downloaded from Goodreads. Select it and click "Open." StoryGraph will read the file and show you a preview of what will be imported — your book titles, ratings, and shelves.

Review the preview to make sure it looks correct. If everything matches what you expect, click "Import" or "Confirm Import." StoryGraph will then upload your library. This can take anywhere from a few seconds to a few minutes depending on how many books you have. You will see a confirmation message when the import is complete.

What transfers and what does not

Your Goodreads export includes book titles, authors, ISBN numbers, your ratings (one to five stars), your reading status (read, currently reading, want to read), the dates you marked books as read, and any custom shelf names you created. All of this information transfers to StoryGraph without any loss.

Your written reviews — the text you typed in Goodreads — do not come through in the CSV export. If you have reviews you want to keep, you will need to save them separately. The easiest way is to copy and paste them into a Google Doc or note-taking app before you export. Some readers also take screenshots of their reviews as a backup.

Troubleshooting common import problems

If StoryGraph says the file is invalid or unreadable, make sure you downloaded the CSV file and not a different format. Goodreads sometimes offers multiple export options — choose "CSV" specifically. If you accidentally chose a different format, go back to Goodreads and export again.

If some books did not import or appear with missing information, this usually means Goodreads could not match them to StoryGraph's database. This happens most often with very new books, self-published titles, or books with unusual formatting in the title. You can add these books manually to StoryGraph by searching for them by title and author. Your ratings and shelf assignments for those books will not transfer, but you can re-enter them quickly once you find the book in StoryGraph.

If your import appears to have worked but you do not see your books on your StoryGraph dashboard, refresh the page or log out and log back in. Sometimes the display does not update when ready after a large import.

After your import is complete

Once your library is in StoryGraph, you can organize it using StoryGraph's own shelving system. StoryGraph calls its shelves "Reading Status" (read, currently reading, want to read) and "Custom Shelves." Your Goodreads shelves will appear as custom shelves, so you can keep them as-is or reorganize them however you prefer.

StoryGraph also lets you set reading goals, track your reading pace, and see statistics about your reading habits. These features work independently of your imported data — they start fresh when you create your account. You can begin using them right away or wait until you have settled into the platform.

Frequently Asked Questions

Can I import my Goodreads reviews into StoryGraph?

The CSV export from Goodreads does not include review text, so they will not transfer automatically. If you want to preserve your reviews, copy them to a document before you export. You can then manually add them to StoryGraph after your books are imported, or keep them in a separate file for your own records.

What happens to my Goodreads account after I import to StoryGraph?

Your Goodreads account stays active and unchanged. Importing to StoryGraph does not delete or modify anything in Goodreads. You can keep both accounts running at the same time, or stop using Goodreads whenever you are ready.

Will my ratings and reading dates transfer correctly?

Yes. Your star ratings and the dates you marked books as read both transfer through the CSV file. StoryGraph will show the same ratings you gave in Goodreads, and your reading history will be preserved.

What if I have thousands of books in my Goodreads library?

StoryGraph can handle large libraries. The import may take longer — anywhere from a few minutes to an hour for very large collections — but there is no limit on how many books you can import. You will see a progress indicator while the import runs.

Can I import to StoryGraph and keep using Goodreads at the same time?

Yes. Importing to StoryGraph does not affect your Goodreads account. You can maintain both libraries, though you will need to update each one separately if you want to keep them in sync.