Repository navigation
Finding a Setting
Settings is a lot of dialog — ten sections and well over sixty controls. Rather than opening each section in turn to find the one you want, type what you're after and Gubbins shows every matching setting from every section at once.
Where to find it: the search box at the top of Settings.

Start typing and the section rail steps aside, replaced by a single list of the settings that match — whichever section they normally live in. Each group of results is captioned with the section it came from, so you still learn where the setting lives.
The controls in the results are the real ones: change a setting straight from the results without navigating to its section first. A count above the list says how many settings matched.
Clear the box (the ✕ at its right, or press Esc while it's focused) to put the rail back and return to the section you were on.
A setting matches when every word you type appears somewhere in:
- its name — e.g.
oledfinds Pure black (OLED); - its description — the one-line explanation under the name;
- its help text — the fuller explanation behind the ⓘ badge; or
- the section or tab it sits in — so
scanner beepfinds Beep on scan, taking "scanner" from its section and "beep" from the row.
Words can appear in any order and in any of those places, and case doesn't matter. Typing a
section name on its own — hotkeys, branding — brings back everything in it.
💡 Tip Searching the help text as well as the name is what makes vague memories work. You don't have to remember that the setting is called Kiosk mode —
wake lock,tabletorawakeall find it.
ℹ️ Note Only settings you actually have are searchable. If you've switched a capability off in Modular UI, its settings are gone from the dialog, so they won't turn up in a search either.
- Modular UI — hide the features (and their settings) you don't use.
- Command palette & shortcuts — the same type-to-find idea for jumping to items and screens.
- Appearance & theming — the settings most people go looking for.
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
- Filling fields from a database
- Low stock & gauges
- Counting by weight
- Container weights
- Bulk edit & clone
- Deduplicating items
- 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
- Sharing settings between devices
- 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
- Finding a setting
- Appearance & theming
- Branding
- Dashboard & widgets
- Modular UI
- Language & region
- Units of measure
- Notifications
- Kiosk & tablet mode
Reference