Skip to main content

Linking a Blueprint to a POS product

Connect a Blueprint or Modifier Blueprint to the POS product that gets sold at the till. Without the link, sales won't deduct stock automatically.

Linking a Blueprint to a POS product

Building a Blueprint or a Modifier Blueprint isn't enough on its own — for sales to actually deduct stock, it must be linked to the POS product that gets rung up at the till. This article covers how to make that connection.

The same linking mechanics apply to both Blueprints (base products like Latte, Burger, Gift Box) and Modifier Blueprints (modifiers like Oat Milk, Extra Shot, Premium Wrap). Both types have a POS Product field that connects them to a single product in your POS catalog.

Without the link: the Blueprint or Modifier Blueprint exists but does nothing when a sale happens. With the link: every sale of that POS product flows into Stash on the next 15-minute sync and triggers the appropriate deduction (or swap).

Who can do this

Only Admins can link Blueprints or Modifier 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 or Modifier Blueprint must already exist at the same shop as the POS product.

How to link to a POS product

Open the Blueprint or Modifier Blueprint, click Edit, set the POS Product field, and save. You can also set this when first creating it — there's a POS Product picker right under the Location field.

Linked items show a green POS linked badge in their list. Unlinked ones show a muted Not linked badge if their shop has a POS connection but no link is set.

  • Base products (drinks, dishes, bundles, kits) → link a Blueprint to the POS product

  • Modifiers (oat milk, extra shot, gift wrap, gluten-free bun) → link a Modifier Blueprint to the POS modifier product

Modifiers come through your POS as their own line items on the order, so they need their own POS product link — the same as any other sellable item. The Modifier Blueprint then handles the deduction (and optional swap reversal) when that line is processed. See What is a Modifier Blueprint? for the full rationale.

When does the link start working?

Linking takes effect immediately for the next POS sale that the sync picks up. Sync runs every 15 minutes, so:

  • Link at 10:00

  • Customer buys the product at 10:05 (order closes at the till)

  • Stash's next sync runs at 10:15 (or whenever the next cycle is) and deducts the components

Past sales are not retroactively deducted. If sales of this POS product were synced and processed before the link was set, those sales were marked "skipped (no blueprint)" and won't be re-processed when you link later. Stash never goes back and applies a Blueprint or Modifier Blueprint to historical orders. Plan ahead: create and link before a busy day, not after.

For full sync mechanics, see How POS sales deduct stock automatically.

Good to know

One-to-one within a shop

The link is one-to-one within a shop. Two Blueprints can't share the same POS product link in the same shop, and a single Blueprint can only link to one POS product. The same rule applies to Modifier Blueprints. (You can have a Blueprint with the same name and recipe at multiple shops — each one links to that shop's own 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 you don't want to deduct anything

If you sell items that don't need any deduction at all — say, a service charge, a tip product, a bag fee — leave them unlinked. Stash will simply skip those lines when the order syncs.

If you sell a simple item where one POS product = one inventory item (a pre-packaged bottle of water you stock as-is, a single t-shirt SKU), you still need a Blueprint with one component (1 of that item). Stash does not auto-match POS products to inventory items by name or SKU — the Blueprint link is always required.

You can re-link a POS product to a different Blueprint or Modifier Blueprint at any time. Past sales are not retroactively recalculated — only future sales use the new link.

Troubleshooting

"I can't find my POS product in the dropdown"

The POS Product picker only shows products from POS connections at the same shop as the Blueprint or Modifier Blueprint. If your POS isn't connected for that shop, or the catalog hasn't been synced yet, the dropdown will be empty. Connect the POS first, run a catalog sync, then come back to link.

"I linked it but stock still isn't deducting on sales"

Check these in order:

  1. Wait at least 15 minutes since the sale closed — sync is on a 15-min cycle

  2. The POS connection is active and not stale (open Integrations to verify)

  3. The POS location mapping is set up. See Mapping POS locations to Stash shops.

  4. The Blueprint's components have valid units and content quantities (open it and check the deduction preview — no warnings should be visible)

  5. The order in your POS is actually closed (open tickets and parked orders don't sync)

  6. The sale happened after the link was set (linking doesn't backfill — orders synced before the link existed are marked "skipped" and stay that way)

See Why my Blueprint isn't deducting stock for the full diagnostic.

Did this answer your question?