Files
bookhoard/docs/user/searching-and-filtering.md
T
john-okeefe 9a60196f1d docs(user): update dashboard and bookshelf instructions for sidebar UI
Dashboard:
- Customize Dashboard is opened from the icon button at the right end
  of the Library bar (next to Refresh), and requires a specific library
  selected rather than 'All Libraries'
- Library switching uses the Library dropdown in the bar below the top
  bar (includes 'All Libraries' with counts)
- Collection sections are shown/hidden from the Customize Dashboard
  toggles — the per-collection 'Show on Dashboard' setting is gone
- Mention the hover chevrons for scrolling carousels

Bookshelf:
- Saved filters: document the new toolbar buttons — Filters (opens the
  filter drawer with Apply Filters, Esc, and overlay-click close), Save,
  Load (Saved Filters dropdown with trash-icon delete), and Clear —
  replacing the emoji-labelled Save Filter / Saved Filters buttons
- Tag filtering: filters now live behind the Filters drawer on the All
  Books page
2026-08-20 14:30:05 -04:00

1.3 KiB

Searching and Filtering Books

Tag-Based Filtering

Bookhoard uses Calibre's tag system for categorization. When you import books from Calibre, their tags are automatically available for filtering.

How Tags Work

Tags are keywords or categories assigned to books, such as:

  • Genres: Science Fiction, Fantasy, Mystery, Romance
  • Categories: Favorites, To Read, Read
  • Metadata: Ebook, Owned, Borrowed

Filtering by Tags

  1. Navigate to the All Books page
  2. Click Filters in the toolbar to open the filter drawer
  3. Use the Tags filter input
  4. Start typing to see autocomplete suggestions
  5. Select a tag or press Enter, then click Apply Filters

Example: Typing "Sci" will suggest "Science Fiction"

Combining Filters

You can combine tags with other filters:

  • Tags + Author: Find all Science Fiction by Asimov
  • Tags + Series: Find all Fantasy in the "Wheel of Time" series
  • Tags + Year: Find all Dystopian fiction published after 2000

Tips

  • Tags from Calibre are automatically imported
  • You can add custom tags when editing book metadata
  • Tags use fuzzy matching - "Sci Fi" will match "Science Fiction"
  • Best matching tags appear first in results
  • Autocomplete shows existing tags as you type with relevance scores