Locations — SanadiqCloud
Product version: 1.0.0+1
Last updated: 2026-08-13 Audience: Tenant Owners, Tenant Employees, Regular Users
A. What are Locations?
A Location is a real-world physical address or site. Locations are the top level of the inventory hierarchy:
Location (site / address)
└── Warehouse (facility)
├── Warehouse zones
└── Inventory (stock group)
└── Physical locations (bins)
Locations represent where your warehouses are situated. They contain address information, geographic coordinates, and optional Google Maps integration. A single location can host multiple warehouses (e.g., a large industrial park with multiple buildings).
Locations are logical groupings — they organize warehouse space at the site level. They are distinct from Physical Locations, which are bins and shelves inside a warehouse.
B. Viewing the Location List
Navigate to Inventory > Locations. The list shows:
| Column | Description |
|---|---|
| Name / ID | Display name with location_id |
| City | City from address |
| Country | Country |
| Active | Status indicator |
| Updated | Last update |
Use the search bar to filter by name, city, state, or country.
C. Creating a Location
- Click + Create Location on the locations list page.
- Fill in the fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Display name (max 255 characters). E.g., "New York HQ" |
| Address Line 1 | No | Street address |
| Address Line 2 | No | Apartment, suite, unit |
| City | No | City name |
| State | No | State or province |
| Postal Code | No | ZIP or postal code |
| Country | No | Country name |
| Latitude | No | GPS latitude (-90 to 90) |
| Longitude | No | GPS longitude (-180 to 180) |
| Google Maps URL | No | Link to Google Maps location |
| Active | No | Defaults to true |
- Click Save.
The system generates a unique location_id if you do not provide one. If you supply a custom ID, it must be alphanumeric with underscores and hyphens only.
D. Editing a Location
- Click a location row to open the detail view.
- Click Edit.
- Update any fields as needed.
- Click Save Changes.
You can update the name, address, coordinates, and Google Maps URL.
E. Location Detail View
The detail page shows:
Address & Map Section
- Full formatted address (address_line1, city, state, postal_code, country)
- Google Maps URL — Opens the location in Google Maps
- Coordinates — Latitude and longitude with map preview
Warehouses at this Location
A list of all warehouses associated with this location, including:
- Warehouse Name and Code
- Type badge
- Status indicator
- Link to each warehouse's detail view
Activity
- Created by and Created at timestamps
- Updated at timestamp
F. Activating / Deactivating Locations
- Open the location detail view.
- Click the Active toggle or edit the status.
- Deactivating a location does not deactivate its warehouses. Use this to mark a location as no longer in use while preserving data.
Inactive locations are hidden from warehouse creation dropdowns but existing warehouses continue to function.
G. How Locations Organize Warehouse Space
Locations provide a geographic grouping for your warehouses:
- Multi-warehouse site: A single location can have multiple warehouses of different types (e.g., a main warehouse and a distribution center on the same campus).
- Regional organization: Use locations to group warehouses by city, state, or country.
- Google Maps integration: The coordinates and Google Maps URL enable visual navigation and route planning.
Tip: Name locations descriptively (e.g., "Riyadh Distribution Hub" or "Dubai Retail Storefront") to make the warehouse hierarchy easy to navigate.
H. Location Hierarchy Examples
Single Location, Single Warehouse
Location: "Cairo HQ"
└── Warehouse: "Main Warehouse" (WH-CAI-01)
Single Location, Multiple Warehouses
Location: "Jeddah Industrial Zone"
├── Warehouse: "Distribution Center" (DC-JED-01)
└── Warehouse: "Raw Materials Storage" (WH-JED-02)
Multiple Locations, Multiple Warehouses
Location: "Riyadh HQ"
└── Warehouse: "Main Warehouse" (WH-RUH-01)
Location: "Dubai Fulfillment Center"
└── Warehouse: "Online Fulfillment" (FC-DXB-01)
Location: "Abu Dhabi Retail"
└── Warehouse: "Retail Store Backroom" (RS-AUH-01)
I. Data Validation Rules
| Field | Validation |
|---|---|
name |
1–255 characters, required |
location_id |
Alphanumeric, underscores, hyphens only. Auto-generated if omitted |
latitude |
Must be between -90 and 90 |
longitude |
Must be between -180 and 180 |
google_maps_url |
Max 500 characters |
Next: Stock & Inventory
See also: Warehouses | Warehouse Zones | Physical Locations