The guide

How to export your Goodreads library.

For a library CSV, open the Goodreads website, go to My Books, then Import and export, and choose Export Library. Wait for the file to build, then use the download link on that page. On iPhone, use the website in Safari rather than looking for the library export in the Goodreads app.

From Goodreads shelf to CSV

  1. My Books

    Open the Goodreads website.

  2. Import and export

    Choose Export Library.

  3. Save the CSV

    Keep the original as a backup.

What to check in one exported row

Title
The Lantern AtlasMatch the title and author first.
ISBN13
BlankIf it is empty, compare the edition details.
Exclusive Shelf
readCheck that it appears as finished.
My Rating
4Compare it with the imported rating.
Date Read
2026/10/17Confirm the finish date.
Bookshelves
winter-readsKeep the original CSV for custom shelves.
Fictional row. The real export includes additional columns.

A ReadersGuild guide. About the publisher. Revised .

How do you export your Goodreads library?

  1. 1Open Goodreads on the web. The library CSV export is on the website, separate from an account-data download request.
  2. 2Go to My Books, then Import and export.
  3. 3Click Export Library, wait for the file to build, then download it.

The file is a CSV. Goodreads emails nothing and the link appears on the same page, so stay on it while the export builds.

Taking this file to StoryGraph? Follow the destination and audit guide

Exporting on an iPhone

Open Goodreads in Safari and sign in. If the mobile layout does not show Import and export, request the desktop website from Safari's page menu. Generate the CSV there, then save the download in Files. A computer can be easier for a large library; you can move the file to your iPhone afterwards.

A library CSV and an account-data request are different. Goodreads also documents a privacy download request in account settings. For a reading-app importer, use the library CSV rather than assuming that a broader account download has the same format.

Official instructions: Import or export your books and Export your Goodreads data. Goodreads may change its menus.

What is in the Goodreads export file?

One row per book, as plain CSV: title, author, ISBN, your rating, the average rating, page count, publisher, the date you added it, the date you read it, every shelf you filed it under, and your review text. It is your whole library, readable in any spreadsheet.

Exporting copies that data. It does not delete or change anything in your Goodreads account, so it is worth doing as a backup even if you are staying.

What carries over into ReadersGuild?

currently-reading
Reading
read
Finished
to-read
TBR
  • Your ratings and the dates you finished a book come across with the shelves.
  • Custom shelves do not. Only reading, finished and want-to-read map onto real shelves here.
  • Long reviews do not come across. The export contains them, ReadersGuild does not store them.
  • Re-importing the same file is safe. Books already in your library are matched, not duplicated.

The importer reads the file's own column headers to work out which service it came from, so a Goodreads file still imports correctly if you pick the wrong one.

Check the file before moving your library

Open a copy in a spreadsheet. Look for Title, Author, Exclusive Shelf, My Rating and Date Read. Keep the original file unchanged. Missing ISBNs and different editions can require a manual match; review the import result rather than assuming every row was found.

A finished book with a rating
Check that its Exclusive Shelf says read. Compare My Rating and Date Read with the finished record after import.
A book with multiple editions
Compare the ISBN with your own copy. If the CSV has no ISBN, check the author, publisher and format before accepting a match.
A book on a custom shelf
Look at both Exclusive Shelf and Bookshelves. The first gives the reading status. Keep the original CSV for custom shelf names and reviews.

ReadersGuild is free to start with a limited working shelf. Premium removes the working-shelf limit. Check the allowance shown in your installed app before importing a large unfinished list. Finished history and your original CSV remain yours.

ReadersGuild for iPhone

Bring your reading history with you.

Import your Goodreads CSV, then keep your next reading sessions with your books. Custom shelves and long reviews do not transfer.

See the iPhone import steps

Free to start. Optional paid upgrades. Android is on the email waitlist.

A ReadersGuild bookshelf arranged with books and earned decorations.
Example app bookshelf with sample books and decorations. Importing does not arrange a shelf like this automatically.

How do you export your StoryGraph library?

  1. 1Open app.thestorygraph.com on the web.
  2. 2Go to Manage Account, then Manage Your Data.
  3. 3Click Export StoryGraph Library and download the file.

StoryGraph exports carry your format and your DNF shelf, so those come across too.

Can you export your Fable library?

  • •A current first-party outbound library export procedure was not verified for this guide. Check Fable's help center or ask its support team what files and fields are available for your account.
  • •Keep your Fable account and original notes while you investigate. Fable's Goodreads import instructions describe bringing records in, not taking a library out.
  • •If you obtain a file, inspect its columns and check the destination's supported formats before importing. A CSV file alone does not prove that shelves, dates, ratings or notes will transfer.

We have not verified a third-party extension or a Fable-to-ReadersGuild transfer. This guide does not recommend installing an extension or promise that any CSV will import.

ReadersGuild for iPhone

Bring your reading history with you.

Import your Goodreads CSV, then keep your next reading sessions with your books. Custom shelves and long reviews do not transfer.

See the iPhone import steps

Free to start. Optional paid upgrades. Android is on the email waitlist.

A ReadersGuild bookshelf arranged with books and earned decorations.
Example app bookshelf with sample books and decorations. Importing does not arrange a shelf like this automatically.
Questions

About exporting.

For the library CSV used by reading-app importers, use the Goodreads website under My Books, then Import and export. The account-data download request documented in Goodreads settings is a different process; do not assume it produces the same library CSV.