Help Center

Square Integration

Your Square store and your inventory, always in sync — both ways.

What the Square integration does

Connect your Square account and the two systems stay in sync both ways, automatically:

  • Ring up a sale on your Square POS or online store → the quantity drops here seconds after the order completes, logged in your Activity Log like a scan — so AI Alerts, back-in-stock and auto-reorder react to Square sales exactly like scanner activity.
  • Change a quantity here — mark sold out, receive a purchase order, edit stock → your Square count updates to match. Hit zero here, show sold out there.

It lives on the Integrations page (profile menu), is included on Pro and above, and connecting takes three clicks — no tokens, no settings, just Square’s own “Allow” screen.

Connecting (three clicks)

On the Integrations page, hit Connect Square — you land on Square’s own consent screen — click Allow, and you’re back here, connected. Pick which Square location to sync if you have more than one.

Disconnecting is one click too, and revokes our access at Square entirely. Nothing already synced is changed.

One click: “Send my items to Square”

Already keep your inventory here and want it in Square? One button does the whole migration:

  • Items Square doesn’t have are created — name, price (in your currency), SKU and barcode included, with track-by-stock already turned on.
  • Items Square already has are matched and get stock tracking switched on if it was off.
  • Every count is set to match Inventory Inventory, and every item is linked for two-way sync from that moment.
  • Items without a SKU get one auto-generated (like barcodes) — e.g. II-3F82A1 — saved back to the item.

You get a summary when it finishes: created, matched, counts synced, SKUs generated. Safe to run again anytime — it re-matches and re-syncs counts.

The “Track by stock” rule — the one thing to check

Square has two tracking modes, and only one of them can sync. We hit this ourselves on day one, so here it is in plain words:

  • Track by stock keeps an actual number (“9 left”). This is what our sync reads and writes — at 0, Square shows sold out.
  • Track by availability (Square often suggests it for food and menu-style items) is just an in-stock/sold-out switch with no number behind it — counts can’t drive it, so sync can’t either.

Fix it per item in Square: Items → open the item → enable Track inventory (by stock) for your location. Or skip the whole chore — “Send my items to Square” sets track-by-stock automatically on everything it creates or matches.

One more Square-side detail: whether a sold-out item is hidden from your online store is Square’s own setting (“hide when out of stock”) — the count we sync is what triggers it.

How items are matched

Each Square sale is matched to your inventory by barcode (UPC) first, then SKU, then exact name — and the match is remembered permanently, so renames don’t break it.

If a Square sale includes something we can’t match, you get one gold alert naming the item and what to add (a barcode or SKU). Add it, and the next sale syncs.

Best practice: give every item a barcode or SKU. If you use “Send my items to Square”, this is handled for you — every item ends up with both systems knowing the same codes.

What syncs — and what doesn’t

  • Only completed Square orders deduct stock (open tickets don’t), and each order is counted exactly once — retries and duplicates are ignored.
  • Manual stock edits made in Square (recounts, corrections) flow here too — counts converge from both directions, seconds apart.
  • SKUs, barcodes, prices, names and descriptions sync both ways: change any of them here and the Square item updates; change them in Square and they update here within moments (each edit lands in your Activity Log as “Square edit”). The item editor warns you when a SKU or barcode is already used by another item — duplicates can cross-link items, and Square won’t warn you.
  • Photos sync too: an item’s photo gallery (up to 8, first = main) uploads to the Square item automatically when you edit it — removals and reordering included. And when you reorder or change the main photo in Square, your gallery here follows. Small “Add to Square” batches carry photos immediately; big full-catalog exports skip them for speed (edit an item to push its photos). Photos added inside Square are imported here too — downloaded into your own storage and slotted into the gallery in Square’s order.
  • Only your chosen location syncs; sales at other locations are left alone — unless you use Locations (VIP and above), which map several Square locations to your own stores; see the next article.
  • Batch-tracked items deduct FEFO (soonest expiry first), same as everywhere else in the app.
  • Adding new items here doesn’t auto-create them in Square by default — that’s what “Send my items to Square” and the “Add to Square” bulk action are for (so a 5,000-row import never floods your Square catalog by surprise). Prefer a full mirror? Flip “Auto-add new items to Square” on the Integrations page and every new item — typed, photographed, spoken or imported — is created in Square automatically, tracked and counted.
  • Refunds don’t restock automatically yet — adjust the quantity in either system and the other follows.

Different prices per location (VIP and above)

With Locations, each location's record has its own price, and Square keeps them apart too.

  • Saving a price here on a location's tab sets that location's price in Square. Square calls this "price by location": open the item in Square, find the variation's price, and use Set price by location to see one price per location. Nothing needs to be switched on in Square first.
  • The All locations tab sets the same price at every location, here and in Square.
  • Changing a price in Square for one location comes back to that location's record only.
  • Caution: if you change the item's price in Square for all locations, Square removes its per-location prices, and every location here then follows that single price. To keep different prices, edit per location in Square, or edit here.
  • Items created in Square from here (auto-add or "Send my items") start with the creating location's price as that location's price.

Several Square locations, one account (VIP and above)

With Locations (Warehouse mode → Locations), each of your Square locations maps to one of your own locations, and that location’s warehouses hold that store’s stock:

  • A sale at a Square location deducts from the item record inside the mapped location — the selling warehouse first, then any warehouse there that has the item. Other locations are untouched.
  • Manual stock edits made in Square flow into the matching location the same way.
  • Quantity edits here push to the Square location mapped to the record’s warehouse. Records in a location with no Square mapping (a distribution center, say) push nothing, so central stock never shows as store stock.
  • “Send my items to Square” and “Auto-add new items” set each record’s count at its own Square location.
  • Square locations you haven’t mapped are ignored, exactly like today’s “other locations”.

To set it up: connect Square, open Locations, click Import from Square, put each store’s warehouses inside its location, and pick the selling warehouse. The Integrations page then reads “Syncing by location”.

Can one account sync several Square locations, each to its own warehouse?

Yes, with Locations (VIP and above). Each Square location is mapped to one of your locations, and that location's warehouses hold that store's stock, so a sale at a Square location deducts only there. On the current plans, VIP covers 2 locations, Luxury 5 and Space 10; Pro and Super sync one chosen Square location. To set it up: connect Square, open Locations, choose Import from Square, put each store's warehouses inside its location and pick the selling warehouse.

Does a sale at one store deduct stock only from that store?

Yes, once the store is mapped to its own location. A product kept in several locations has one record per location, and a completed Square order deducts from the record inside the mapped location: the selling warehouse first, then another warehouse in that location that holds the item. Records in other locations are untouched. Without Locations, the single synced Square location deducts from your one record for that product.

Can several Inventory Inventory accounts connect to the same Square account?

Not for the time being. A Square merchant account connects to one Inventory Inventory workspace at a time; a second workspace trying to connect the same Square account is refused, so nothing is overwritten or disconnected. For several stores under one Square account, use one workspace with Locations and map each Square location to its own location. A store with its own separate Square account can connect to its own workspace.