Skip to main content

All Locations

Overview

All Locations is where you build the physical and organisational map of your inventory world. Every stock position, movement, and transaction is tied to a specific location in this tree — so the accuracy of your inventory data depends directly on how well your location hierarchy reflects the real world.

Locations are arranged in a parent-child hierarchy. At the top sits your company (the root), and below it you nest progressively more specific places: countries, cities, warehouses, zones, bins, vehicles, and anything else that holds or moves stock.

The page is found at Inventory Management → Location Management → All Locations.


The Location Tree

The left panel shows the entire location hierarchy as an expandable tree.

Summary badges

Two badges at the top of the tree give a quick count:

BadgeMeaning
Active: NTotal number of active locations
Root locations: NNumber of top-level locations (no parent)
  • Select next to a location to expand it and reveal its children.
  • Select to collapse a branch.
  • Select any location name to open its details in the right panel.

Searching

Use the search bar at the top of the tree to find locations by name or code. The tree filters as you type.


Location Detail

Selecting a location in the tree opens its full record on the right. The record is divided into four collapsible sections.

Header fields

FieldDescription
CodeThe unique identifier for this location (e.g. LYON-SCENT, MAIN-WH). Set at creation and cannot be changed.
NameThe human-readable display name shown in lists and transaction forms.

Basic Information

FieldDescription
DescriptionOptional free-text note about what this location is or where it is.
Parent locationThe location directly above this one in the hierarchy. Empty for root locations.
Location typeThe structural category of this location (e.g. Warehouse, Zone, Storage Location, Mobile). See Location Properties.
Location purposeThe intended activity at this location (e.g. Receiving, Shipping, Storage). See Location Properties.
Owner (responsible worker)The employee responsible for this location. Optional — drawn from HR records.

Address

FieldDescription
StreetStreet address of this location.
CityCity.
CountryCountry.

Addresses are most useful for top-level locations (company, warehouse). Use Clear address to remove all address fields at once.

Operational Flags

FlagDescription
OperationalWhen on, this location is considered active and ready for stock operations. When off, the location exists in the hierarchy but is not used for transactions.

Additional Information

FieldDescription
Parent locationRepeated here for quick reference, with a No parent label for root locations.
Sub-locationsA count of direct child locations (e.g. 3 Sub-locations). Select it to jump to the children.
Created dateWhen this location record was first saved.
Modified dateWhen this location record was last edited.

The INVENTORY tab at the top of the page exposes three quick links to inventory data scoped to the selected location:

LinkWhat it shows
On-handCurrent stock quantities held at this location
Inventory transactionsAll transaction types that involved this location (purchases, sales, assemblies, adjustments)
MovementsMovement operations where this location was the source or destination

Creating a Location

Quick method — from the tree: Select an existing location in the tree, then select + New. The create form opens with that location already set as the Parent location. You can change it if needed.

From scratch: Select + New without selecting anything in the tree first. The parent field will be empty (creating a root location).

Steps:

  1. Select + New (with or without a location selected in the tree).
  2. Fill in the header fields:
    • Code (required) — a unique identifier. Use a clear, consistent format (e.g. WAREHOUSE_A1, ZONE_B, VAN-03). Cannot be changed after saving.
    • Name (required) — the display name.
  3. In Basic information:
    • Description (optional) — add context about this location's role.
    • Parent location (optional) — pre-filled if you started from a selected node; leave empty for a root location. Can be changed from the dropdown.
    • Location type (optional) — classify the location (Warehouse, Zone, Storage Location, Mobile Location, etc.).
    • Location purpose (optional) — assign its intended function (Receiving, Shipping, Storage, etc.).
    • Owner (optional) — assign a responsible worker.
  4. In Address — fill in address details if relevant (most useful for top-level company or warehouse locations).
  5. In Operational flags — set Operational on if this location is immediately ready for stock activity.
  6. Select Save.
Building a hierarchy — create top-down

Always create parent locations before their children. You cannot assign a parent that doesn't exist yet.

Al Baraka's structure was built in this order:

  1. ACME (Company) — root, no parent
  2. Main Warehouse (Warehouse) — child of ACME
  3. Zone A, Zone B (Zone) — children of Main Warehouse
  4. Shelf A1, Shelf A2 (Storage Location) — children of Zone A
  5. Sales Van 01, Sales Van 02 (Mobile Location) — children of ACME
Example — creating a receiving dock

Al Baraka adds a dedicated receiving dock inside their main warehouse:

FieldValue
CodeDOCK-RECV-01
NameReceiving Dock 01
DescriptionPrimary inbound goods receiving area
Parent locationMain Warehouse
Location typeStorage Location
Location purposeReceiving
OwnerAhmed Al Mansouri
OperationalOn

Editing a Location

  1. Select the location in the tree.
  2. Select Edit in the toolbar.
  3. Update any field except Code.
  4. Select Save.
note

The Code is permanent and cannot be changed after creation. If you need to correct a code, archive the location and recreate it — but only if it has no active inventory or sub-locations.


Archiving a Location

Archiving removes a location from selection dropdowns while preserving all its history.

  1. Select the location in the tree.
  2. Select Archive in the toolbar.
  3. Confirm.

To view and restore archived locations, select Archived items in the toolbar.

warning

A location cannot be archived if it currently holds stock or has active sub-locations. Drain the stock (move it elsewhere) and archive or reassign all child locations first.


Planning Your Location Hierarchy

A well-designed hierarchy makes stock queries fast and movement tracking accurate. The key principle: only locations at the bottom of the tree hold actual stock. Higher-level locations (company, warehouse, zone) are organisational containers.

LevelLocation typeHolds stock?Purpose
1CompanyNoOwnership root for all inventory reporting
2WarehouseNoPhysical building; groups zones for filtering
3ZoneNoArea within a warehouse (cold storage, bulk area)
4Storage LocationYesSpecific shelf, bin, or pallet position
Mobile LocationYesVehicle or trolley that moves between sites