Help

How Spineline works, and how to make it work for you.

Your shelf

Importing from Goodreads

How to bring your Goodreads library across, how rows are matched, and what each skipped row means.

Exporting from Goodreads

You want your reading history in Spineline without typing it in. On Goodreads, open My Books, choose "Import and export" under Tools, and choose "Export Library". Goodreads emails you a link to a CSV file; download it.

Uploading the file

In Spineline, open Preferences, then Import, then Goodreads, and upload the file. One import runs at a time, and the page says how large a file it takes. When the import finishes you get a notification.

What comes across

  • Statuses: read becomes Read, currently-reading becomes Reading, to-read becomes Want to read, and did-not-finish becomes Did not finish.
  • Ratings, to the nearest half star. Ratings of four stars or more follow authors and series, as any rating does.
  • The date you read a book, when your Spineline entry has none.

Your own Goodreads shelves, reviews, and the date you added a book are not imported. Books already on your shelves are left as they are.

How rows are matched

Each row is matched to the catalog by, in order: a shared map of Goodreads books already matched, the book's ISBN, and its title together with its author. A title alone is never enough: the author must match too, and a row naming a volume must match that volume.

Skipped rows

The import report groups the rows it could not bring across:

  • "not in our catalog yet": nothing in the catalog matched. Spineline may search other book sources for it (below); you can also add the book yourself from search.
  • "title matched, different author": a book with this title exists, by someone else. Spineline may search other book sources for it too; otherwise, search for it by author and add it yourself.
  • "matches more than one book in a series": the row fits several volumes and nothing in it says which. Add the right volume from search.
  • "our catalog lists these volumes as one book": the catalog holds several volumes as a single book, so they cannot be tracked apart; the report names the book they were listed with.
  • "unreadable records": the row was missing what an import needs, or used a status Spineline does not have.

For rows in those two groups, Spineline may keep searching other book sources - library catalogues and book databases - after the import finishes. The report then says how many books it is still looking for, marks those rows "Still looking", and says how long the search goes on. Each book it finds is added to your shelves with the status, rating, and read date from your file, and the first one it finds sends you a notification. Books it does not find stay in the skipped list.

Two more groups are not problems: "already on your shelves" and "duplicates in the file".

Other services

Goodreads is the only service you can import from. Importing from StoryGraph and others is not supported yet.