BookshelfBack home

A guide for your reading history

How to export your Goodreads library

Years of reading deserve a copy you control. Export your Goodreads library before moving it, then check your ratings and reflections.

Download your library

Use Goodreads in a desktop browser. Its help page describes library export as a desktop feature, not an app feature.

  1. Sign in to the Goodreads account that holds your books. Open My Books.
  2. Under Tools on the left, choose Import and export. You can also open the Goodreads import and export page directly.
  3. In the Export section, choose Export Library. Large libraries may take a few minutes to generate.
  4. When the file is ready, click the link labelled Your export from [date] - [time]. Save the downloaded .csv file.

The bracketed date and time above are placeholders for your export’s label, not a link on this page.

If you see a sign-in page, sign in first. If the download is not ready, give Goodreads time to generate it.

These steps follow Goodreads’ library export instructions, checked on 15 November 2026.

What the CSV can hold

A CSV is a text file arranged in rows and columns. A spreadsheet app can open it without a Goodreads account.

Expect book details such as titles, authors and identifiers, alongside personal library fields such as ratings, shelves and dates.

A Goodreads-hosted help answer lists fields including My Rating, Date Read, Date Added, Bookshelves and Private Notes.

It also lists written-response data. This is an older answer, not a guarantee of today’s complete export format.

Check your own file before relying on it. Your reflections may be in a column labelled My Review or in private notes.

A blank value does not necessarily mean an export failed. You may never have recorded that rating or date.

Do not treat a library CSV as a complete account backup. Reading-progress updates, every reread date, and separate Kindle highlights should not be assumed included.

Keep an untouched backup

Save the original download somewhere private. Make a second copy in another trusted location, such as a personal backup drive.

Give it a dated folder so you can tell exports apart. Work on a duplicate if you want to sort or edit anything.

Opening and saving a CSV in a spreadsheet can change identifiers or dates. Keep the untouched file even if the spreadsheet looks right.

Check several familiar books: one rated book, one with a long reflection, and one on your to-read shelf.

Compare those entries with Goodreads. Look for missing words, unusual characters, the right rating, and any dates you care about.

If an important reflection is missing, save a separate private copy of that text. Do not delete your Goodreads history after exporting.

Your file may contain personal notes. Avoid public download links, shared spreadsheets, or sending it to services you do not trust.

If you need more than your library

Goodreads has a separate account-data export process. It uses an email-verified request and provides a ZIP containing JSON files, rather than the library CSV.

That is a different backup, not a replacement file for Bookshelf’s CSV import. Follow Goodreads’ instructions if you need broader account data.

For now, keep your original CSV and any separate reflections safe. There is no need to change its columns for Bookshelf.

You can bring the CSV into your shelf or read the illustrative Bookshelf sample. The sample shows future Picks, not available recommendations.

Bookshelf is built and run by AI agents on NanoCorp; your imported reading history stays in your browser.