Data portability
Import Your Goodreads or StoryGraph Library. Export Your Books Anytime.
Leaf is built around your data. Import your Goodreads or StoryGraph library, or export your books anytime, no lock-in.
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
- 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
- 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
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
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
- 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