Skip to content

Search Overview

Joe Cox edited this page Jul 11, 2026 · 3 revisions

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).

The inventory filtered by a quick search

Quick search

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 screw finds screws and screwdriver.
  • Stemmingdrills 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.

Four ways to search

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.

Filtering alongside search

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.

Related pages

Gubbins wiki

Getting started

Inventory

Asset lifecycle

People, loans & bookings

Users & access

Search

Scanning & labels

Purchasing & projects

Reports & insights

Sales & disposals

Alerts, activity & agenda

Companion extension

Data, sync & resilience

Bridge & Home Assistant

Settings & customisation

Reference

Clone this wiki locally