Data portability
How to Export Your Goodreads or StoryGraph Library, and Import It Into Leaf
Getting your library out is the easy part. This page walks through both halves: how to export your books as a CSV file, and how to bring them into Leaf.
New here? Leaf is where your library can land
Leaf is a free reading tracker for iPhone and Android, built around a daily reading habit instead of a social feed. You set a pace, log a few pages a day, and keep a streak going. When you import, your books arrive with their statuses, page counts and finish dates intact, so you pick up exactly where you left off.
Free reading tracker
Import your Goodreads or StoryGraph library in a couple of minutes, and start a reading streak the same day.
Import from Goodreads
Leaf can import your entire Goodreads library: books, statuses, and page counts.
Step 1: Get your Goodreads export
- 1. Go to goodreads.com and open My Books
- 2. Click "Import and export" at the bottom-left of the page
- 3. Click "Export Library"
- 4. Wait for the file to generate, then download it
Step 2: Import into Leaf
Don't have Leaf yet? It's free on iPhone and Android. Install it first, then:
- 1. Open Leaf → Settings → Data → "Import from Goodreads"
- 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
Import from StoryGraph
Leaf can import your entire StoryGraph library: books, statuses, ratings, and finish dates.
Step 1: Get your StoryGraph export
- 1. Go to app.thestorygraph.com and open Manage Account
- 2. Under "Manage Your Data", tap "Export StoryGraph Library"
- 3. Open the email from StoryGraph and download the CSV file
Step 2: Import into Leaf
Don't have Leaf yet? It's free on iPhone and Android. Install it first, then:
- 1. Open Leaf → Settings → Data → "Import from StoryGraph"
- 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)
- Star ratings and finish dates
- Duplicates are detected and skipped automatically
Why readers bring their library to Leaf
- Everything transfers: titles, authors, ISBNs, reading statuses, ratings and finish dates.
- Free to use, with an optional Leaf Pro subscription. No account required to start.
- Private and offline-first: no followers, no public profiles, no algorithmic feed.
- Export it all back out as a CSV whenever you like. Nothing is locked in.
Free reading tracker
Import your Goodreads or StoryGraph library in a couple of minutes, and start a reading streak the same day.
Export your library
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
Page Count
Total pages - empty if unknown
Format
physical or ebook - empty if not set
Progress Unit
pages or percent - empty if not set
Cover Customized
true if the cover was set manually - empty otherwise
Notes
Your notes and quotes for the book, with page numbers - empty if none
Import from a Leaf export
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
- Your notes and quotes, restored with their page numbers
- 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
Page Count
—
Total pages, empty if unknown
Format
—
physical or ebook, empty if not set
Progress Unit
—
pages or percent, empty if not set
Cover Customized
—
true if the cover was set manually, empty otherwise