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

  1. Click + Create Location on the locations list page.
  2. 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
  1. 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

  1. Click a location row to open the detail view.
  2. Click Edit.
  3. Update any fields as needed.
  4. 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

  1. Open the location detail view.
  2. Click the Active toggle or edit the status.
  3. 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