Skip to main content
Back to home

Data portability

Bring your books in. Take them with you.

Leaf is built around your data. Import your Goodreads library or export your books anytime, no lock-in.

Import from Goodreads

Available

Leaf can import your entire Goodreads library: books, statuses, and page counts.

Step 1: Get your Goodreads export

  1. 1. Go to goodreads.com and open My Books
  2. 2. Click "Import and export" at the bottom-left of the page
  3. 3. Click "Export Library"
  4. 4. Wait for the file to generate, then download it

Step 2: Import into Leaf

  1. 1. Open Leaf → Settings → Data → "Import from Goodreads"
  2. 2. Tap "Select CSV file" and choose your downloaded file

What gets imported

  • Book title, author, and ISBN
  • Reading status (Reading, Finished, Want to Read, Dropped)
  • Page count (if present in your export)
  • Duplicates are detected and skipped automatically

Export your library

Available

Get a full backup of your Leaf data at any time.

Open Leaf → Settings → Data → "Export Library", then share the CSV file anywhere: Files, iCloud, email, AirDrop, and more.

What's in the file

Column

Notes

Title

Book title - always present

Author

Author name - empty if not set

ISBN

ISBN-13 - empty if not set

Status

Reading · Want to Read · Finished · Dropped

Date Added

YYYY-MM-DD format

Date Finished

YYYY-MM-DD format - empty if not finished

Current Page

Latest page reached - only for Reading and Dropped books that have logged progress

Cover URL

Book cover image URL - empty if not set

Import from a Leaf export

Available

Restore a Leaf library you previously exported from the app.

Open Leaf → Settings → Data → "Import from Leaf CSV", then tap "Select CSV file" and choose your Leaf export file.

What gets imported

  • Title, Author, ISBN
  • Reading status (Reading, Want to Read, Finished, Dropped)
  • Date Finished (Date Added is not preserved)
  • Current Page, for books that had reading progress
  • Duplicates are detected and skipped automatically

Building your own CSV

You can also create a CSV from scratch to import books from any source — useful when migrating from an app that supports CSV export.

Column

Required

Notes

Title

Yes

Book title

Status

Yes

Reading · Want to Read · Read · Dropped (case-sensitive)

Author

Author name — empty if not set

ISBN

ISBN-10 or ISBN-13 — empty if not set

Date Added

YYYY-MM-DD format

Date Finished

YYYY-MM-DD format — only for Read books

Current Page

Latest page reached — only for Reading and Dropped books

Cover URL

Book cover image URL — empty if not set