Linking a Blueprint to a POS product
Building a Blueprint isn't enough on its own — for sales to actually deduct stock, the Blueprint must be linked to the POS product that gets rung up at the till. This article covers how to make that connection.
Without the link: the Blueprint exists but does nothing when a sale happens. With the link: every sale of that POS product automatically deducts the Blueprint's components from your inventory.
Who can do this
Only Admins can link Blueprints to POS products.
Before you start
Your POS must be connected to Stash. See Connecting your POS to Stash.
You must have run at least one product sync from your POS so the products show up in Stash.
The Blueprint must already exist at the same shop as the POS product. See Creating your first Blueprint.
How to link a Blueprint to a POS product
Method 1: from the Products page
From the sidebar, open Products.
Find the POS product you want to link. The Blueprint column shows whether it's linked yet.
Click the row to open the product.
In the Blueprint field, search for and select the matching Blueprint.
Save.
Linked products show a checkmark in the Blueprint column. Unlinked ones show a dash and won't deduct stock on sale.
Method 2: from the Blueprint
Open Blueprints.
Open the Blueprint you want to link.
Click Edit.
Set the POS product field to the matching product.
Save.
Either method achieves the same thing — pick whichever feels faster for you.
Finding unlinked POS products
The Integrations page shows a banner at the top whenever you have POS products that aren't yet linked to Blueprints. Click the banner to jump straight to the Products page filtered to unlinked items. Tackle them in priority order: highest-selling products first.
Good to know
One Blueprint per POS product, one POS product per Blueprint
The link is one-to-one. You can't have two Blueprints linked to the same POS product, and a single Blueprint can only be linked to one POS product.
If you sell the same finished product at multiple shops, you need:
One Blueprint per shop (because each shop has its own components)
One POS product per shop (POS systems usually do this anyway, since each location has its own catalog)
One link per shop
POS products without a matching Blueprint
If you sell items that don't need component tracking — say, a pre-packaged bottle of water that you stock as-is — you don't need a Blueprint for them. Stash can deduct the POS product directly from inventory if the product matches an inventory item by name or SKU. The Blueprint link is only needed when components differ from the finished product. See How POS sales deduct stock automatically.
Changing the link later
You can re-link a POS product to a different Blueprint at any time. Past sales are not retroactively recalculated — only future sales use the new link.
Troubleshooting
"I can't find my Blueprint in the dropdown"
The dropdown only shows Blueprints from the same shop as the POS product. Confirm the Blueprint exists at the same location. If it doesn't, create one (or use a different one) at that shop.
"I linked it but stock still isn't deducting on sales"
Check these in order:
The POS connection is active and not stale (open Integrations to verify).
The location mapping between POS locations and Stash shops is set up. See Mapping POS locations to Stash shops.
The Blueprint's components have valid units and content quantities (open the Blueprint and check the deduction preview — no warnings should be visible).
A sale has actually happened since you linked it. Old sales (before linking) won't trigger backfills.
See Why my Blueprint isn't deducting stock for a deeper troubleshooting walkthrough.
Related articles