Skip to main content

Mapping POS locations to Stash shops

Tell Stash which POS location is which Stash shop. Without this mapping, sales come in but Stash doesn't know which inventory to deduct from.

Written by Jake
Updated today

Mapping POS locations to Stash shops

If your POS has multiple physical locations (e.g., three Square locations or two SumUp shops), you need to tell Stash which POS location corresponds to which Stash shop. Without this mapping, Stash receives sales but doesn't know which inventory to deduct from.

This is a one-time setup per POS connection. After that, sales flow to the right Stash shop automatically.

Who can do this

Only Admins can map locations.

When you'll see this

Right after you connect a POS, Stash automatically imports all your POS locations and presents them on the Integrations page in a Location mapping card. Each POS location shows a dropdown where you pick the Stash shop it belongs to. See Connecting your POS to Stash.

How to map locations

  1. From the sidebar, open Integrations.

  2. Find the POS connection's Location mapping card.

  3. For each POS location listed, pick the matching Stash shop from the dropdown.

  4. The mapping saves automatically β€” no Save button needed.

The Setup card at the top tracks progress: X of Y locations mapped. You're done when that hits 100%.

Good to know

Single-location accounts

If your POS has only one location, you still need to do the mapping (one click) so Stash knows where to send sales.

One Stash shop per POS location

Each POS location maps to exactly one Stash shop. You can't split a single POS location's sales across multiple Stash shops.

Two POS locations to the same Stash shop

This is allowed but unusual. If two POS locations physically operate in the same shop (e.g., a main till and a satellite till), you can map both to the same Stash shop. Sales from either will deduct from the same inventory.

POS locations you don't use in Stash

If a POS location exists in your POS but you don't want it tracked in Stash, leave its dropdown empty (unmapped). Stash will ignore sales from that location.

Adding a new POS location later

If you add a new location to your POS, click Sync now on the Integrations page to pull it in. Then map it.

What happens after mapping

  • Stash starts listening for sales from each mapped POS location

  • Sales are routed to the correct Stash shop's inventory

  • The Setup card flips the Map locations step to Done

  • The next step (Sync products) becomes available

Troubleshooting

"I don't see my POS location in the list"

Click Sync now on the Integrations page to refresh location data from your POS. If it's still missing, the location may not be active in your POS β€” check there first.

"I mapped a location but sales aren't appearing in Stash"

Confirm three things:

  1. The POS connection is healthy (no warning icon)

  2. The location mapping is saved (refresh the page to confirm)

  3. Real sales have happened since you finished the mapping

If all three check out, see Why my Blueprint isn't deducting stock for the deeper diagnostic.

Related articles

Did this answer your question?