Locations and Stock
Locations are where your items live, and stock is how many you have in each one. Together they answer the two questions Gubbins exists to answer: what have I got? and where is it?
Where to find it: the location tree down the side of the Inventory screen.
Locations are hierarchical — a location can sit inside another, as deep as you like:
Garage → Shelf A → Bin 3
Each location can have:
- A name — a room, shelf, drawer, box, or anywhere else things live.
- A colour — a swatch that tints the location and the cards of items stored in it, so the grid reads at a glance.
- A description — surfaced as a tooltip when you hover the location.
- A parent — the location it sits inside.
Selecting a location filters the inventory to what it holds, including everything nested beneath it. Select All items to clear the filter.
💡 Tip The tree is fully keyboard-navigable: arrow keys move between locations, Left/Right collapse and expand, and Enter selects. Great for quick filtering without reaching for the mouse.
💡 Tip You can drag an item card onto a location to move its stock there — a fast way to tidy up after a reorganise.
The key idea: Gubbins tracks quantity separately in each location. If you have 200 screws on Shelf A and 50 in the Kitchen, that's one item with a total on-hand of 250 — but the app remembers the 200/50 split. Adjust the count where the stock physically is, and the item's total keeps itself correct automatically.
ℹ️ Note An item's total quantity is always the sum of its per-location stock — you never edit the total directly, you edit stock somewhere.
A transfer moves quantity from one location to another. The total on-hand doesn't change — the stock just now lives somewhere else. This is how you record moving a batch of parts from receiving to a shelf, or loading tools into a van.
A location can be given a capacity, after which Gubbins shows a fullness gauge — handy for knowing when a shelf or bin is running out of room before you over-fill it.
Beneath each location, stock can be split further into batches & lots — useful when different deliveries have different expiry dates, so Gubbins can consume the oldest first.
- Core concepts — how items, stock and locations relate.
- Batches & lots — expiry tracking and first-expiry-first-out.
- Cycle counts & audit day — checking that on-hand counts match reality, location by location.