Out of Stock in the POS

Out of Stock in the POS

1. Enabling the Feature in Back Office

  1. Sign in to Back Office.

  2. Navigate to Stores and select the target store.

  3. Open Store settings and go to the General tab.

  4. Enable Prevent ordering out-of-stock items.

  5. Click Save.

  6. Sync POS for the store to push the updated configuration to registers.

Important: The feature is not active on POS until the sync is completed. Always sync after changing this setting.

2. How POS Enforces Stock Checks

When the feature is enabled, POS performs a real-time stock check at every point where inventory could be consumed.

Triggered actions:

Adding an item to cart

Checks available stock against requested quantity

Increasing item quantity

Re-checks stock including quantity already in cart

Confirming a matrix variant selection

Checks stock for the selected variant specifically

Confirming a modifier for a recipe product

Checks ingredient stock consumed by the modifier

Key calculation rule: POS always accounts for the quantity of the same item (or ingredient) that is already in the current cart before comparing against available stock.

3. Behavior by Product Type

Standard Products

POS checks the product’s own stock level.

  • If the stock is zero or unavailable, POS blocks the add action entirely.

  • If the requested quantity plus cart quantity exceeds available stock, POS blocks the action and shows how much stock remains.

  • The quantity of the same item in the cart is always included in the check.

Products with ingredients

POS checks the ingredient stock rather than the product’s stock directly, because Products with ingredients are built from components.

  • Ingredient usage already consumed by other lines in the current cart is included in the check.

  • If selected modifiers require additional ingredients, those ingredients are validated as well.

  • If any ingredient is out of stock, the Products with that ingredient cannot be added.

  • If a modifier’s required ingredient is out of stock, that modifier cannot be applied.

Matrix Products

POS checks the stock for the specific variant selected by the cashier, not the matrix parent.

  • The quantity of the same variant already in cart is included in the check.

  • If the selected variant has insufficient stock, POS blocks the action and displays a stock error.

  • Other variants of the same matrix product are not affected.

    POS Error Messages Reference

    Standard product fully out of stock

    Out of Stock. This item cannot be added to the cart.

    Standard product — quantity exceeds stock

    Insufficient Quantity. Total stock is {stock_amount}.

    Ingredient out of stock

    The ingredient '{ingredient_name}' is out of stock. This item cannot be added to the cart.

    Modifier ingredient out of stock

    The modifier "{modifier_name}" cannot be applied because the ingredient "{ingredient_name}" is out of stock.

    Matrix variant — insufficient stock

    Stock error shown at variant confirmation step

    Troubleshooting

    Use this guide when stock blocking is not working as expected.

    1

    Back Office setting — confirm Prevent ordering out-of-stock items is enabled for the store

    2

    POS sync — confirm the register has completed a successful sync after the setting was saved

    3

    Connectivity — check network status on the register; look for an inventory load error message on the POS screen

    4

    Wait and retry — POS performs automatic inventory refreshes; waiting for the next cycle may resolve transient data issues