Skip to content
Now with GPT-6 Astra support

Inventory

Stock Tracking, Reservations & Back-in-Stock

Last updated: November 13, 2026

Stock Tracking #

Stock lives on variants. Every product sold through the cart, checkout, POS or a manual order is sold as a variant, so the variant's number is the one that counts:

  • Simple products — the product's stock is its single variant's stock.
  • Configurable products — the product's stock is the total of its active variants.
  • Bundles and products without variants keep their own stock number.

The product's number is updated in the same step as every sale, reservation, release and adjustment, so product cards, the "In stock" filter, search results, the APIs and the admin always show what can actually be sold. A sold-out product never shows as in stock.

A low-stock threshold determines when a product appears in the Low Stock Alert widget on the admin dashboard.

The threshold can be set globally in Catalog Settings and overridden on a per-product basis.

Checkout Reservation #

When a customer initiates checkout, their items are atomically reserved. This prevents two customers from purchasing the same last unit simultaneously.

Reservations expire after a configurable timeout (default: 30 minutes). If the customer abandons checkout without completing payment, the reservation expires and the stock is released automatically.

Abandoned carts don't wait for that timeout. When the hourly abandoned-cart job notifies a shopper about their cart, it releases that cart's reservation at the same time, so the stock returns to sale immediately instead of staying held until the reservation lapses.

Unpaid pending orders are automatically cancelled after a configurable period (default: 24 hours). Until then, a pending order holds its stock: orders paid offline (bank transfer, cash on delivery, invoice and similar) keep their units reserved until they are paid or cancelled, instead of releasing them after the 30-minute checkout timeout. A Stripe checkout session always expires before its stock hold does. Cancellation releases any stock still held by the order.

If a payment arrives for an order that has already been cancelled or refunded, STOAR does not reopen the order. The payment is flagged for manual review, so stock, coupon uses and gift-card balances are never silently taken twice.

Back-in-Stock Notifications #

Customers and guests can subscribe to be notified when a sold-out product or variant is restocked. Only an email address is required — no account is needed.

Notifications are sent automatically when a product or variant's stock is updated from zero to a positive quantity.

Managing Inventory #

Stock levels are edited directly on each product and variant page in Admin → Catalog → Products. Editing the stock of a simple product updates its variant. A configurable product's stock is calculated from its variants, so you edit the variants instead.

The admin dashboard includes a Low Stock Alert widget that lists all products at or below their low-stock threshold, so you can identify items that need restocking at a glance.