Track stock and avoid overselling

3 min read

Single-unit listings

Each Unit has a stock number. When the unit sells, mark it Sold in the admin — it disappears from the storefront automatically.

Parts & accessories (Parts module)

Each Product has a numeric stockQty. When a customer places an order:

  1. We check stockQty >= quantity before accepting checkout.
  2. On payment, we decrement stockQty atomically.
  3. When stockQty == 0, the storefront shows "Out of stock" and the Add-to-cart button is disabled.

Variants

If a product has variants (sizes, colors), stock is tracked per variant. The base stockQty is ignored.

Low-stock alerts

A bell notification fires when any product crosses your low-stock threshold (default 3). Change the threshold in Settings → Store.

Common gotcha

If you decrement stock manually in the database, the storefront won't recalc until the next page load. Always update via the admin UI — it busts the right caches.

Didn't answer your question?

Send us a note — we usually reply within a few hours.

Email support