Skip to main content

Importing and Exporting Books

You can import and export your library to back up your data or move it between tools.

Exporting Your Library

You can back up your library or move your data to other platforms by exporting it in various formats.

  1. Navigate to Settings and select the Data tab.
  2. Under the Request data section, use the dropdown menu to choose your preferred file format: CSV, HTML, or JSON.
  3. Click the Request data button to generate and download your file.

Importing Books

You can populate your BookLogr library in bulk by importing existing data.

  1. Navigate to Settings and select the Data tab.
  2. In the Import books section, choose the appropriate platform from the dropdown menu:
    • BookLogr CSV: For re-importing data previously exported from BookLogr.
    • Goodreads CSV: For migrating your library from Goodreads.
  3. Click Browse to select the file from your computer.
  4. Optionally, check Add duplicate books if you wish to import entries that may already exist in your library.
  5. Click Upload to process the file and add the books to your collection.

A screenshot of the BookLogr settings interface, showing the "Data" tab. The "Request data" section includes a format dropdown (CSV, HTML, JSON) and a "Request data" button. Below it is the "Import books" section with a platform dropdown, a browse button for file selection, an "Add duplicate books" checkbox, and an "Upload" button.


BookLogr CSV Format

If you are creating a file manually or building a third-party tool to interact with BookLogr, your CSV must adhere to the following structure. All columns must be present, even if they are empty.

CSV Specification

ColumnTypeDescription
titleStringThe full title of the book.
isbnStringThe 10 or 13-digit ISBN.
descriptionStringA summary or synopsis of the book.
reading_statusStringOne of: Read, Currently reading, To be read, Did not finish.
current_pageIntegerThe number of pages read so far.
total_pagesIntegerThe total page count of the book.
authorStringThe full name of the author.
ratingIntegerA numeric rating (leave empty if not applicable).
notesJSON ArrayAn array of notes or quotes, e.g., [].

Example File

title,isbn,description,reading_status,current_page,total_pages,author,rating,notes
Northern Lights,9780702311413,"Description text here",Read,199,199,Philip Puleman,,[]
Harry Potter and the Half-Blood Prince,0786277459,"Description text here",Currently reading,38,831,J. K. Rowling,,[]
note

Ensure your CSV uses standard comma separation and that fields containing commas or newlines are properly enclosed in double quotes (e.g., the description field).