Warehouse
Set up warehouses and zones, lay out the physical map, and visualize picker routes.
The Warehouse section is where the physical shape of your operation lives. You set up each facility and its zones, draw the rack layout on an interactive map, and see the exact route a picker walks for any pick list. Everything else on the floor, from putaway to picking, reads the bins and locations you define here.
Who can see and change this
The whole Warehouse section is operator-only, so brand accounts never see it. Role gating differs by page, though: on the Manage page, creating or editing warehouses and zones is admin-only (operators see it read-only, without the Add/Edit buttons). The Map editor and its Import dialog have no such gate — any operator can drag, add, or delete racks, edit bins, and import inventory. Treat the Map as a shared editing surface.
The section has three pages, matching the sub-nav under Warehouse:
Warehouse Management
Create warehouses, edit their address and operating schedule, and organize them into zones.
Map
The interactive layout editor — place racks, edit bins, import stock, and check walkways.
Visual Pick Routes
Replay a pick list as a walking route on the map.
Warehouse Management
Manage → /warehouse. The landing page lists your warehouses — every one
under All warehouses, or just the pinned building when you've picked one in
the topbar warehouse switcher
(which also scopes the Map and Visual Picks). Each warehouse expands to show its
zones.

Each warehouse row shows its name, city and state, and a badge with the zone count. Expand it to see the zones table, with each zone's name and type. A brand new warehouse with no zones yet reads "No zones yet — add zones to organize your warehouse." If no warehouses exist at all, the page shows "No warehouses configured yet."
Add a warehouse
The Add Warehouse button (top right, admins only) opens a panel for the facility's details. Only the name is required.

| Field | Notes |
|---|---|
| Warehouse Name | Required. |
| Address, Address Line 2 | Street address. |
| City, State / Province | |
| ZIP / Postal Code, Country | |
| Phone |
Edit a warehouse and its operating schedule
The Edit button on a warehouse row opens the same address fields, plus an Operating schedule block that the earlier create form doesn't have.

The schedule has two parts:
- Business days — toggle the days this warehouse runs (Mon through Sun). New warehouses default to Mon–Fri. Hours outside these days don't count against the on-time rate for orders shipped from this warehouse.
- Timezone — the IANA zone for the facility. It decides which calendar day a UTC timestamp belongs to, so a Friday 11pm UTC ship time counts as Friday in New York but Saturday in Tokyo. The dropdown lists common presets, and keeps whatever exotic zone a warehouse was already set to.
The schedule here drives the SLA math on the dashboard. The SLA target itself (the promised turnaround) is a per-brand setting and lives on the client, not the warehouse.
Add a zone
The Add Zone button on a warehouse row (admins only) creates a zone inside that warehouse. A zone has a name and a type.

There are seven zone types. The dropdown shows friendly labels when you pick one, but the zones table renders the raw type in capitals:
| Type | Used for |
|---|---|
| RECEIVING | Inbound dock and staging. |
| STORAGE | Reserve and bulk storage. |
| PICKING | Pickable forward locations. |
| PACKING | Pack benches and stations. |
| SHIPPING | Outbound staging and dock. |
| RETURNS | Returns processing. |
| QUARANTINE | Held or damaged stock. |
Map
Map → /warehouse/editor. An interactive, zoomable plan of the warehouse
floor. Racks are drawn to scale, and the toolbar in the top left switches
between five tools. To move around: a plain scroll or two-finger drag pans;
to zoom, hold ⌘/Ctrl and scroll or pinch on a trackpad. (The separate
Visual Pick Routes map zooms on a plain scroll — the two maps differ.)

If your tenant has more than one warehouse, pick the one you want from the warehouse selector at the top of the app first. The map edits one warehouse at a time, so "All warehouses" isn't a valid choice here — you'll see a prompt to pick a specific one.
The toolbar has five modes, plus a Locations button for special locations (below) that isn't a mode. The hint bar in the bottom left always tells you what the current tool does.
Select
The default tool. Click any rack section to open the Sections panel on the right, which lists every section in the warehouse and lets you drill into its bins. Hovering a rack shows its bin label as a tooltip. Hold Shift and drag to draw a marquee and select several racks at once.
The Sections panel is searchable by label, rack, or face. Expand a section to see:
- Its label (for example
A001-BA), which you can rename with the pencil. Labels follow theA000-BAformat — aisle number, then a two-letter section. - Badges for the rack name, which face it's on, the rack type, the bin and stocked counts, and total units.
- A bin layout grid, one row per level (
L0,L1, …). Each cell is a bin, and a filled cell shows how many SKUs sit in it. Click a bin to see its contents — SKU image, code, name, and unit count. You can add or remove levels, and add or remove totes per level, right from here.
Edit
Edit mode lets you rearrange the floor. Drag a rack to move it — placement snaps to the grid, and the rack refuses to overlap another. Select several (Shift+click or a Shift+drag marquee) to move them as a group. Two keyboard shortcuts:
- Delete or Backspace removes the selected rack. Because a rack holds every section in its column, this deletes the whole rack, so you get a confirm first. The real removal runs a server-side inventory check when you save — if any bin under the rack still holds stock, the save is blocked.
- F flips a rack's face direction (west to east), which moves the walkway to the opposite side.
Add
Add mode opens the Add Rack panel and drops you into a placement flow. Move your cursor over the map to preview where the rack lands, click to drop it, drag to fine-tune, then confirm with Place rack section (or Place pallet location).

The panel controls what you're placing:
- Name — defaults to the next aisle in the
A0NNconvention, editable. - Type — Shelf (1 face) or Pallet location. Shelf racks hold lettered sections; pallet locations are single-tote positions.
- Sections / Locations — how many section cells the rack spans, set with the +/– stepper.
- Direction — whether sections run Down or Up from where you click.
- Starting section (shelf only) — the first section's letter, for example
BA. Later sections auto-increment (BA,BB,BC, …). - A per-section accordion where you set the bin layout — the number of levels and totes per level. Shelf sections default to 6 levels of 3 totes.
If the preview overlaps something, it turns amber and the panel tells you to drag it clear or flip the direction. Place stays disabled until the spot is clear.
Walkways
Walkways mode overlays the aisles the system computes between your racks. It's a read-only check. A rack face whose walkway side is blocked by another rack shows in red, so you can spot an unreachable location before it causes picking problems.
Import
Import mode opens the Import Inventory dialog, which loads stock into the warehouse's bins from a CSV. It's built for the ItemLocations export format, and runs in three steps.

Choose the file. Drop or browse to a CSV with Item, Sku, Location,
Units, and Type columns. Extra columns are ignored, and SKUs are
auto-created from the Item and Sku columns.
Review the preview. Every row is validated against the map and tagged with a status: Ready, No bin (the location isn't in this warehouse), Invalid (missing SKU, location, or units), Negative, 0 units, or Not Bin. The badges across the top total each bucket, including how many rows will overwrite existing stock. Choose Overwrite (the default — row units replace existing stock, safe to re-run a full snapshot) or Append (row units add to existing, which double-counts if you re-run a snapshot).
Import. If any rows would replace existing stock, you confirm first. The done screen summarizes rows imported, SKUs created, and SKUs matched, and lists any rows that didn't import with the reason.
If your CSV references bins that aren't drawn on the map yet, a banner stays up listing the missing sections, so you can switch to Add mode, create them, save, and re-run the import.
Special locations
Not everything on the floor is storage. Locations in the toolbar places the three named markers a warehouse can have, one of each:
- Depot — where a pick run starts and ends. Routing reads it: the last aisle's exit end is chosen by how close it leaves the picker to the depot. A warehouse with no depot sequences from the middle of the layout instead.
- Returns Station — where returns are processed. A marker for now; put-back routes will start from it.
- Wholesale Station — where wholesale cartons and pallets get built and staged for a retailer's carrier. A marker for now; nothing routes from it.
Pick one from the menu, then click the map to drop it. Markers stay visible in every mode, and clicking one opens a panel where you can rename it or remove it from the map. The name is display copy only, so calling the depot "Packing Station" changes what the map and the picker screen say and changes nothing about routing. To move a marker, switch to Edit mode and drag it — it snaps in half-cell steps so it can sit on a walkway line or a cross-aisle rather than only on a rack cell.
Moving the depot changes how new routes are sequenced. Pick lists that already exist keep the order they were built with, so it's safe to move mid-shift. Markers save with the rest of the map, and they never block a save — a returns desk standing in front of a rack is legitimate, so an overlap is flagged as a note, not an error.
Saving your changes
Moves, additions, and deletions are staged on the canvas and committed together. As soon as you have unsaved edits, Discard and Save appear in the toolbar, and the app warns you if you try to leave the page with changes pending. A save can be blocked for a few reasons, each shown in a Cannot save layout dialog:
- Bin label conflicts — a new bin's label already exists in your tenant. Bin labels have to be unique.
- Racks with active dependencies — deleting a rack whose bins still hold stock, or that has active work or rules against it. Move the stock or clear the work first.
- Layout overlaps — a rack body or face position collides with another.
Visual Pick Routes
Visual Picks → /warehouse/visual-picks. This page replays a pick list as a
walking route drawn on the warehouse map, so you can see the path a picker takes
and how the stops are ordered.

Pick the warehouse (if you run more than one) and then a pick list from the dropdown, which shows each list's short id, status, and item count. The map draws the route from the depot through every stop in order, and a sidebar lists the stops.
Each stop in the sidebar shows its number, the bay label, and how many picks happen there. Use Show all to fit the whole route in view, or the Previous and Next arrows to step through stops one at a time, zooming to each. Until you choose a pick list, the map reads "Select a pick list to view route."