-
Notifications
You must be signed in to change notification settings - Fork 0
Search Overview
Gubbins is built to find things fast. However big your inventory gets, there are four ways to narrow it down — from a quick type-ahead to a precise, saveable query.
Where to find it: the Search items box at the top of the Inventory screen (and the command palette from anywhere).

Just start typing in the Search items box. Gubbins matches across your items' names and details as you type, powered by a fast full-text index:
-
Prefix matching — typing
screwfinds screws and screwdriver. - Stemming — drills and drilling find drill.
- Fuzzy matching — a small typo still finds the right item.
💡 Tip Press Escape in the search box to clear it without reaching for the mouse.
| Way | Best for | Page |
|---|---|---|
| Quick search | Finding something by name, fast | (this page) |
| Plain English | A natural request without learning any syntax | Natural-language search |
| Text syntax | Power users who want precise field:value control |
Text query syntax |
| Visual builder | Building complex AND/OR queries by clicking | Visual query builder |
The last three all live in the Visual search panel (open it from the More menu on the Inventory screen) and all do the same thing under the hood — they build up a filter you can refine, re-run and save.
Search combines with the other ways to narrow the list:
- Location — selecting a location in the tree limits results to that place. See Locations & stock.
- Status chips — quick filters for things needing attention (low stock, expiring, overdue, maintenance due). See Alerts.
- Category and tag facets — narrow to a category or tag.
ℹ️ Note When the Visual search panel is driving the results, it takes over from the quick-search box and status chips — so you're always looking at exactly one query's results, never a confusing mix.
- Capabilities — searchable, weighted attributes with best-match ranking.
- Saved searches & favourites — keep and recall queries.
Gubbins · a local-first, offline inventory app · Report an issue
Getting started
Inventory
- Items
- Tracking modes
- Locations & stock
- Location photos & regions
- Batches & lots
- Variants & SKUs
- Kits & bundles
- Tags, attachments & related
- Custom fields & capabilities
- Low stock & gauges
- Counting by weight
- Container weights
- Bulk edit & clone
- Inventory views
Asset lifecycle
- Warranty & depreciation
- Current value & revaluation
- Maintenance & servicing
- Test & calibration records
- Condition grading
- Cycle counts & audit day
- Insurance & estate schedule
People, loans & bookings
Users & access
Search
- Search overview
- Visual query builder
- Text query syntax
- Natural-language search
- Saved searches & favourites
Scanning & labels
Purchasing & projects
- Projects & BOM
- Budgets
- Purchase orders
- Reorder & shopping list
- Wishlist
- Supplier parts & price history
- Suppliers
Reports & insights
- Reports overview
- Valuation & spend
- ABC, turnover & aging
- Sales & margin
- Data hygiene
- Parts catalogue
Sales & disposals
Alerts, activity & agenda
Companion extension
Data, sync & resilience
- How your data is stored
- Cloud sync
- Backup & restore
- Export & import
- Migrating from another tool
- Storage triage
- Danger zone: erasing data
Bridge & Home Assistant
- Bridge overview
- Running the bridge
- Bridge API tokens
- Home Assistant
- AI assistant query (MCP)
- Webhooks
- Webhooks, MQTT & iCal
Settings & customisation
- Appearance & theming
- Branding
- Dashboard & widgets
- Modular UI
- Language & region
- Notifications
- Kiosk & tablet mode
Reference