Location mapping is mandatory to run the Shopify integration. Until every Shopify location is assigned to a Katana location, the integration will have a Disabled status, and cannot be activated.
Why map locations?
If you use multiple locations in Katana or Shopify, mapping them ensures that:
Sales orders (SOs) from Shopify are imported into the correct Katana location.
Stock levels are synced between the correct Katana and Shopify locations.
Shopify can automatically assign fulfillment locations based on availability.
Katana acts as your central source of truth for inventory.
How to map locations
Open the Shopify configuration page in Katana.
Go to the Inventory tab.
The Location mapping section lists every active Shopify location alongside a Katana location selector.
Pick a Katana location from the dropdown for each Shopify location. You can click Manage Katana locations to open location settings and create/edit Katana locations — the mapping selector will pick them up immediately.
Mapping rules
Every Shopify location must be mapped. If any row is left empty, the integration stays in Disabled.
One Katana location can be mapped to multiple Shopify locations. For example, an "Online Shop" Shopify location and a "POS" Shopify location can both point to the same physical Katana warehouse.
One Shopify location maps to one Katana location. You can't split a single Shopify location across multiple Katana locations.
Only Katana locations with Sell enabled are available in the dropdown.
What mapping affects
Order imports. Each imported sales order row is assigned the Katana location matching the Shopify fulfillment location.
Initial stock import. Stock pulled from Shopify is added to the mapped Katana location. If multiple Shopify locations point to the same Katana location, their stock totals are summed before the import.
Inventory level sync (Katana → Shopify). Stock pushed to Shopify is pushed to the mapped Shopify location. If a Katana location is mapped to multiple Shopify locations, the same stock value is applied to each.
Fulfillment-location updates. When a Shopify order's fulfillment location changes, Katana updates the order row's location to the mapped Katana location.
Changing a mapped location
You can remap a Shopify location at any time.
The mapping takes effect immediately for new data:
New stock pushes go to the new Katana location.
New incoming orders are imported to the new mapping.
Existing Katana sales orders keep the location they were imported to.
If you delete a mapping, the integration changes to Disabled, and the sync stops until every location is mapped again.
Tips
Run the location mapping before the initial stock import. Stock import uses the current mapping and is hard to undo.
If you have a multi-store setup, each Shopify store has its own mapping. Mapping changes in one store doesn't affect another.
POS locations in Shopify can be mapped just like online ones — there's no special handling.
Your feedback is invaluable. Let us know your thoughts on this article or anything in Katana you'd like to see improved: [email protected]