Files
bookhoard/docs/user/collections.md
T
john-okeefe 8ca95db08a docs(user): update admin and collections instructions for sidebar UI
Admin:
- Admin pages live in the sidebar's Administration panel (Dashboard,
  Libraries, Hash Conflicts, Users, Settings)
- Library creation is the Create Library modal (Library Name,
  Description, Library Type); folders are added afterwards by expanding
  the library row and using the Folders section's path input + Browse +
  Add — the old Add Library modal with folder and 'Scan on save' fields
  no longer exists
- Scanning is via the Scanner API or watch mode (File Watcher status on
  the admin dashboard); remove references to the removed per-library
  Rescan button and 'Force Rescan' option

Collections:
- Fill in the empty creating/managing placeholders with the real flow:
  New Collection button, modal fields (name, description, icon grid,
  color swatches), per-collection edit/delete icon buttons, Restore
  System button, and dashboard-section visibility via Customize
  Dashboard
2026-08-20 14:30:10 -04:00

1.6 KiB

Collections

Collections allow you to organize books across multiple libraries.

Viewing Collections

From Collections Page

Navigate to Collections (sidebar navigation) to see all your collections. Clicking on a collection shows ALL books in that collection across all libraries.

From Dashboard

When viewing a specific library's dashboard, collections only show books from that library. Clicking "View All" preserves this context and shows only books from that library in the collection.

Library Filtering

  • No filter (/collections/favorites): Shows all books across all libraries
  • With filter (/collections/favorites?library_id=xxx): Shows only books from the specified library

Creating Collections

  1. Go to Collections (sidebar navigation)
  2. Click New Collection (top-right) — or Create Your First Collection if the list is empty
  3. Fill in the details:
    • Name - Collection name
    • Description - Optional description
    • Icon - Pick from the icon grid
    • Color - Pick a color swatch
  4. Click Create Collection

Managing Collections

Each collection in the list has icon buttons on its card:

  • Edit - Opens the edit form to change name, description, icon, or color. Click Update Collection to save.
  • Delete - Removes the collection after a confirmation prompt.

Deleted a system collection by mistake? The Restore System button on the Collections page brings back system collections.

Dashboard Sections

Collections appear as sections on your dashboard. Show, hide, and reorder them from the dashboard's Customize Dashboard settings (see Dashboard).