For librarians

Adding books by scanning

Turn a barcode into a full catalog record in seconds, on the Catalog tab.

The Catalog tab opens on Browse, your whole collection. Click Add books to switch to the scanning screen, titled “Add to your shelves.” That’s where a pile of books becomes a catalog. Most books take about two seconds each.

Scan or type an ISBN

In the box that says “Scan, type an ISBN, or search a title or author,” do exactly that: scan the barcode on the back of the book, or type the ISBN, and press Enter (or click Find). The box also takes a title or an author: anything that isn’t an ISBN becomes a search, and you pick the right edition from the results.

A USB barcode scanner is the fastest way. It just types the number and presses Enter for you, so you can point, beep, and move to the next book without touching the keyboard. You can also use your phone’s camera with the Scan barcode button.

In a second or two, BeeShelf finds the book and shows the cover, title, author, publisher, and a summary.

The Add books screen in the Catalog tab, showing a resolved book with cover, title, author, a copy-count stepper, and an Add to catalog button
A scanned book, resolved and ready to add. The badge flags whether the record came back complete or sparse.

No barcode? Photograph the cover

Some books have no barcode and no ISBN. If your library has cover scanning turned on, a Photograph cover button sits next to Scan barcode: photograph the front cover and BeeShelf reads the title and author off it, then runs that as a search. You still pick the right edition, so the record itself comes from the catalogs exactly as it would from a scan.

Cover scanning is off by default and is switched on per library by BeeShelf. If you don’t see the button, your library doesn’t have it turned on, and a barcode-less book goes in by hand instead.

Confirmed, or Needs review

Every match carries a small badge:

  • Confirmed means the record came back complete, with a summary. You can add it without a second look.
  • Needs review means the record is sparse: a catalog had the book, but no summary came with it. Nothing is wrong with the match, there’s just thin detail for readers to find it by. Add it anyway, or press Edit details first to write a summary and add topics.

The first time anyone on BeeShelf looks up a given book, the record is saved and shared, so the next library that scans the same ISBN gets it instantly. You’ll often see “instant (cached)” on common titles.

Add one copy, or several

If you have more than one copy of the same book, use the and + buttons to set the count, then press Add to catalog (the button reads Add 3 copies when you’ve set three). Each copy becomes its own item with its own barcode.

To skip a result without adding it, press Skip.

Keep an eye on the sidebar

The right-hand sidebar tracks your session:

  • Added this session counts what you’ve added since you opened the Add books screen. It resets if you switch to Browse or reload the page.
  • A small cache and AI percentage shows how much came straight from catalogs versus needed filling in.
  • An Edit a copy box finds any copy already on your shelves by barcode, title, or author, so you can pull one up to edit without the book in hand.
  • Below it, the list shows the last books you added. Click any one to edit it (see Adding books by hand and editing copies).

When a book isn’t found

Older, regional, and self-published books sometimes aren’t in any catalog. When that happens you’ll see “We couldn’t find that one.” You can:

  • Press Add it by hand to type the details yourself. What you enter is saved for everyone.
  • Press Try another to move on.

Both paths are covered in Adding books by hand and editing copies.

Importing a list

If you already have your collection somewhere else, use Import catalogue, at the top of this screen, to bring it in all at once instead of scanning each book. It takes a CSV (a Libib or spreadsheet export) or a MARC file (.mrc or MARCXML, including Koha item records). See Import your library for the full walkthrough.