Niovela Open the app
Guide · Leaving StoryGraph

How to import your StoryGraph library

The StoryGraph lets you export everything as a CSV, and Niovela recognises the format on its own — the same Import button reads Goodreads and StoryGraph files. Your read statuses, ratings, dates, tags and reviews come across in a few minutes, free, and without creating an account first.

Free · No account needed · Your library stays on your device

What comes across, and what does not

Stated plainly, because most importers are vague about this.

📚

All four statuses

Read, Currently reading, To read and Did not finish map to Finished, Reading, To read and Abandoned. StoryGraph has a proper DNF status and Niovela keeps it.

Ratings, dates and rereads

Star ratings come across; StoryGraph allows half and quarter stars, so they are rounded to whole stars. Last date read becomes the finish date, Date added is kept, and Read count becomes your rereads.

🏷️

Tags become lists, reviews come along

Each tag with at least two books becomes a private list. Your written reviews are imported too — as private, so nothing is published without you deciding it.

🚫

What stays behind

Moods, pace, content warnings and the character questions are StoryGraph's own and are not imported. Nothing is invented either: a book is only added under a real identity, never as a placeholder.

Import your StoryGraph library in 5 steps

Nothing to install. The whole thing takes a few minutes.

1

Export from StoryGraph

On the StoryGraph website, open your profile menu and go to Manage your data → Export StoryGraph library. StoryGraph prepares the file and emails you a link, or offers it for download. Save the .csv.

2

Open Niovela and go to Settings

Open Niovela in your browser — no sign-up, no download. Tap your profile, then Settings → Import.

3

Drop in the CSV

Choose the file. Niovela detects that it is a StoryGraph export from its columns — you do not have to tell it — and shows how many books it found and how many it can import before anything happens.

4

Start the import

Books with an ISBN are looked up in batches so each one lands as a real edition with its cover and page count. Books whose ISBN/UID is a StoryGraph identifier rather than an ISBN are keyed by title and author and enriched when you open them.

5

Check what came across

At the end you get the counts: imported, already there, skipped and not imported — with the titles of the last group, so you can add those from the search in seconds.

📄 StoryGraph does not export page counts. Niovela fills them in from the catalogue when it resolves the ISBN; a book without an ISBN gets its pages the first time you open it.

What you get once it is in

The reason to move, not just the mechanics of moving.

🆓

Free, with no paid tier

No Plus plan, no locked stats. Everything Niovela does, it does for everyone.

📊

Stats across all your years

Pages, genres, top authors, rating distribution, an activity heatmap, books per year and a yearly goal — from your own history, not just this year.

🔒

Private by default

Your library lives on your device. Nobody sees your shelf unless you decide they should, and reviews, quotes and follows have their own switches.

📤

Export whenever you want

Settings → Export gives you your whole library as JSON or CSV, any time. Leaving should be as easy as arriving — that is the point of this page.

Frequently asked questions

How do I export my library from StoryGraph?

On the StoryGraph website, open your profile menu, then Manage your data, then Export StoryGraph library. You get a CSV file. The same export works whether you are on the free or the Plus plan.

Is importing free?

Yes. The import is free, Niovela is free, and you do not need to create an account — your library is saved on your device. An account is only needed if you want to sync between devices.

Do half stars survive?

They are rounded to the nearest whole star: Niovela rates in whole stars. 3.5 becomes 4, 3.25 becomes 3.

Why do some books have no page count?

Because the StoryGraph export does not include pages. Niovela fills them in from the catalogue when it resolves the ISBN, and for books without an ISBN the first time you open them.

Are my reviews imported?

Yes, as private reviews: only you see them until you publish the ones you want, one by one from each book or all at once from Settings. Publishing needs an account, because a public review has an author.

What about moods and content warnings?

They are not imported. They are StoryGraph's own vocabulary and Niovela does not have an equivalent, so nothing would be gained by keeping a field you cannot use.

Can I get my data back out of Niovela?

Yes, at any time: Settings → Export gives you the whole library as JSON or CSV. No lock-in.

More from Niovela

Your life in books.

Bring your statuses, ratings and reviews across and pick up where you left off — free, no account needed.

Import my library