Connecting Square POS
Square is the recommended POS for SMBs using Stash. Connection takes about 2 minutes and uses Square's standard OAuth flow — Stash never sees or stores your Square password.
Who can do this
Only Admins can connect Square. You'll also need to sign in to Square as the account owner (a regular employee account won't have permission to authorize integrations).
Before you start
You need at least one Stash shop set up. See How to add your first location.
You need your Square account owner login.
Allow popups for app.getstash.io in your browser — Square's authorization opens in a popup window.
How to connect Square
From the sidebar, open Integrations.
Find the Stash shop you want to connect Square to.
Click Connect POS.
Choose Square from the provider list.
Sign in to Square with your owner account.
Review the permissions Stash is requesting (read-only access to products, locations, and sales) and click Allow.
You'll be redirected back to Stash. The connection appears in seconds.
Once connected, Stash automatically pulls in your Square locations and starts a product catalog sync.
After connecting — finish the setup
The Setup card on the Integrations page walks you through the remaining steps:
Locations imported — happens automatically right after connecting
Map locations — tell Stash which Square location is which Stash shop. See Mapping POS locations to Stash shops.
Sync products — pull in your Square catalog (run automatically the first time, manual after)
Link Blueprints — connect each Square product to a Blueprint so sales deduct components. See Linking a Blueprint to a POS product.
Each step shows as Done, In progress, or Action needed.
Good to know
Multi-location Square accounts
If your Square account has multiple locations, all of them are pulled in. You then map each one to the right Stash shop. One Square account can serve as the data source for multiple Stash shops.
Modifiers and variations
Square modifiers (like sizes or extras) come in as separate POS products. You'll need a Blueprint per variation if the components differ. For example, a Small Cappuccino Blueprint and a Large Cappuccino Blueprint, each linked to its respective Square modifier.
Refunds and voided sales
Square refunds and voids are reflected in Stash — refunded items return to inventory automatically.
What Stash doesn't access
Even though Square handles a lot of data, Stash only reads what's needed: products, locations, and sale events. It doesn't read customer info, card numbers, employee details, payouts, or invoices.
Troubleshooting
"The popup didn't open"
Your browser blocked it. Allow popups for app.getstash.io and try again. On Chrome: click the popup-blocked icon in the address bar and choose "Always allow."
"Square is asking me to log in to a specific business"
If you have multiple Square businesses, log in to the one whose data you want in Stash. You can connect a different one to a different Stash shop later.
"I see locations imported but no products"
The product sync runs after locations are mapped. Map your locations first, then click Sync now to pull products.
"I authorized but the connection doesn't show in Stash"
Refresh the Integrations page. If still missing, the popup may have closed too quickly — try connecting again.
Related articles