Storage Locations

Map out where your equipment lives — from stations down to individual compartments.

Storage Locations describe the physical places where your gear is kept. Like categories, they can nest under one another, so you can build a hierarchy that matches your real buildings: a station containing rooms, rooms containing cabinets, cabinets containing shelves. Each location has a name, an optional description, a type, and an optional parent. From this screen you can add, edit, and delete locations, and everything saves and sends up automatically.

Overview

The header reads Storage Locations. Each location appears as a card with these lines and two round buttons in the bottom-right corner.

Line on the card	What it shows
Name :	The location's name, in bold.
Description :	The optional note. Blank if none was entered.
Parent Location :	The location this one sits inside. Blank if it is top-level.
Type :	station, room, cabinet, shelf, or compartment.
Items :	How many items are stored here.

Button	Color	What it does
Pencil (Edit)	Blue	Opens Edit Location with the existing values filled in.
Trash (Delete)	Red	Asks you to confirm, then removes the location.

The three-dot button at the top right holds a single menu choice: Add Location.

Getting Here

1. Open the Account tab and tap the Inventory module.
2. On the Inventory landing screen, tap Storage Locations.
3. The screen opens with the header Storage Locations and a card for each one.
4. Tap the Back arrow to return to the Inventory landing screen.

An agency administrator can also reach this screen from Agency Settings → Inventory → Storage Locations.

Adding a Location

1. Tap the three-dot menu at the top right and choose Add Location. The New Location screen opens.
2. Enter a name in the Location Name field. This is the only required field — leaving it blank brings up "Please enter a location name." when you try to save.
3. Optionally add a Description.
4. Tap the Type field to choose one of station, room, cabinet, shelf, or compartment. Until you pick one, the button reads Select.
5. Tap the parent selector to nest this location inside another. The list starts with None, followed by every existing location. Leave it on None for a top-level place.
6. Tap Save. The new location appears in the list and becomes available to pick when adding items.

Fields on the New Location form

Field	Type	Required?	Notes
Location Name	Single-line text	Yes	Spaces at the start and end are trimmed.
Description	Multi-line text	No
Type	Dropdown	No	Five fixed choices. Can be left unset.
Parent selector	Dropdown	No	Starts with None, then every other location.

The header reads New Location when adding and Edit Location when editing.

Location types

The five types are labels that describe the scale of the place. They are not enforced — the app will let you put a station inside a shelf — so use them the way they read naturally.

Type	Typically holds
station	The whole building or site. Rooms sit inside it.
room	An apparatus bay, storeroom, or office. Cabinets sit inside it.
cabinet	A locker, cupboard, or rack. Shelves sit inside it.
shelf	One level within a cabinet. Compartments sit inside it.
compartment	The smallest unit — a bin, drawer, tray, or slot.

tip

Build your locations from the largest to the smallest — create the station first, then add rooms, cabinets, and shelves under it. This way the parent selector already shows the right choice each time you add the next level down.

Editing a Location

1. Find the location and tap its blue pencil (Edit) button.
2. The Edit Location screen opens with the name, description, type, and parent already filled in.
3. Update any fields you need. The location you are editing is automatically left out of the parent list, so it cannot be set as its own parent.
4. Tap Save. A brief "Location updated" message appears and you return to the list.

If you tap Back with unsaved changes, the app asks "Data Updated — Do you want to save changes?":

Choice	What happens
Save	Checks the name, then saves and returns to the list.
Cancel	Discards your edits and returns to the list.

Tapping Back with nothing changed returns to the list without asking.

Deleting a Location

1. Find the location and tap its red trash (Delete) button.
2. A confirmation appears titled Delete with the message "Are you sure you want to delete this location?"
3. Tap Delete to remove it, or Cancel to keep it.
4. The location disappears from the list. Offline deletions are queued and send when you reconnect.

caution

Deleting a location does not delete the items stored there — it just leaves them without a place on record. On the Items list their Location : line falls back to whatever Location Details text they carry, or goes blank. Re-file them before or after the cleanup.

Saving Online and Offline

Situation	What the app does	What you see
Online, save succeeds	Sends the location to the server and mirrors it into the saved copy on your device.	"Location added" or "Location updated", then the list.
Online, save fails	Falls back to the offline queue so your work is not lost.	No error — it appears in the list and sends later.
Offline	Saves on your device and queues it.	It appears in the list immediately.
Parent still queued	Queues the child too, regardless of your connection, and holds it until the parent has reached the server.	Both appear in the list immediately.
Editing a location that has not reached the server yet	Queues the edit rather than sending it.	The edit appears in the list immediately.
Offline delete	Removes it from your device and queues the deletion.	The card disappears.
Online delete fails	Shows the error the server returned and keeps the location.	An alert with the server's message.

Loading, Empty, and Offline States

Situation	What you see
Opening while online	The saved list paints instantly, then a spinner runs and the list refreshes.
Opening while offline, with saved data	The saved list appears. No error message.
Opening while offline, never synced	An empty screen with no cards. Connect once and reopen.
Server does not answer but you have cards	Your cards stay on screen with no alert.
Server does not answer and the list is empty	An alert shows the error the app received.
Returning from Add or Edit	The list re-paints from saved data and the queue is nudged to send.

A location with no description, no parent, or no type still shows those lines, blank after the label. The Items : count comes from the server, so a location you just created offline reads 0 until it has synced.

How This Connects

• Where the data comes from. Storage locations live on your agency's server and are kept in a saved copy on your device, which is what lets this list appear instantly and work offline.
• What updates it. Saves on this screen, saves by a teammate, and edits an agency administrator makes in Agency Settings → Inventory → Storage Locations. The Items : count is calculated on the server from your item records — you cannot type it in.
• Locations feed the item form. Every location you create here appears in the Storage Location dropdown on the Items form, with -- None -- at the top of the list. They arrive in the same combined request that loads items, categories, manufacturers, templates, and vehicles.
• Locations show on item details. The Storage Location Name line on the Item Details page in Browse Items comes from the record you keep here.
• Location versus Location Details versus Vehicle. A Storage Location is a place your agency has defined. Location Details is free text on the item for a bin or slot number too specific to be worth its own record. Vehicle means the gear travels with a unit rather than sitting in a building. An item can carry all three.
• Browse organizes by category, not place. Browse Items walks the category and container tree. To see what is stored somewhere, scan the Location : line on the Items list.
• Beyond Inventory. A station address your agency keeps on its profile can be opened in maps from Agency Profile or Map Location; the storage locations here describe the places inside those buildings.
• Offline and reconnect. New and edited locations appear in the list straight away and are queued. The queue drains when you reconnect, when you reopen this screen, and right after a save. A nested location is held back until its parent has reached the server, and an item is held back until the location it points at has synced.

Troubleshooting

If this happens	What to do
"Please enter a location name." appears	The Location Name field is empty or only spaces. Type a name and save again.
"Missing organization." appears	The app has lost track of your current agency. Close and reopen the app, then try again.
The Type button still reads Select	Type is optional, so the app saves without it. Tap the field and pick one if you want it on the card.
The parent list does not offer the location you want	You cannot set a location as its own parent, so it is left out. Pick a different one.
A new location is not in the Storage Location dropdown on the item form	The dropdown is filled in when the form opens. Tap Back and open the form again.
Items : shows 0 for a location you know holds gear	The count comes from the server. Items added offline are counted once they sync and the list refreshes.
Item cards show a bin number instead of a place name	Those items have no Storage Location set, so the card falls back to Location Details. Edit them on Items.
A location you deleted keeps coming back	The deletion may have failed on the server. Go online, reopen this screen so the queue sends, and watch for an error alert.
A teammate's new location is missing	Go online and reopen the screen. Server changes arrive on refresh.
Your hierarchy came out in the wrong order	Edit each location and set the correct parent. Working largest to smallest avoids this.

Related Pages

• Items
• Manufacturers
• Browse Items
• Categories

---

⬅️ Previous: Manufacturers | Next: Templates ➡️