Product Availability Display feature overview

Edit on GitHub

The Product Availability Display feature shows stock quantities on product detail pages, in shopping carts, and in the Buy Box in marketplace scenarios. When you enable the feature, availability displays in three states: in stock with quantity, available (for never-out-of-stock products), or out of stock.

Display modes

The feature supports two display modes:

Indicator only: Shows the availability status without quantities. Products display as “Available” or “Out of stock.”

Indicator with quantity: Shows the availability status with exact quantities. Products display as “19 in stock” or “Out of stock.”

Stock display on product detail page

Availability information appears on product detail pages for concrete products (specific product variants).

Product detail page showing stock quantity

When a product has available inventory, the system displays the quantity. The format is “X in stock,” for example, “19 in stock.”

Never-out-of-stock products

Products marked as never out of stock display “Available” without showing a quantity. These products remain available regardless of inventory levels.

Product showing available status

Out of stock

When a product has zero available inventory and is not marked as never out of stock, the system displays “Out of stock”.

Product showing out of stock

Dynamic updates with variant selection

When customers select different product variants, such as color or size, the availability display updates automatically to show stock for the selected variant.

Stock display in shopping cart

Availability information appears for each line item in the shopping cart.

Shopping cart showing availability

Each cart item displays its current availability status, for example “19 in stock” or “Available”. If stock levels change after a customer adds items to the cart and before checkout, the cart display reflects the current availability.

The system validates stock availability during checkout. If the requested quantity exceeds the available stock, checkout cannot be completed until the customer adjusts the order.

Measurement unit support

When products have measurement units configured, availability displays with the unit.

Product with measurement unit

For example, “225.5 m in stock” instead of “225.5 in stock.” The measurement unit is appended to the quantity based on the product’s configured base unit.

Stock display in Buy Box

In marketplace scenarios, when combined with the Buy Box feature, availability information appears per merchant offer. Customers can see stock availability for each merchant selling the product.

For details about Buy Box integration, see Buy Box feature overview.

Configuration

You configure the Product Availability Display feature at the code level. The following configuration options are available:

  • Enable or disable stock display: The feature is disabled by default.
  • Display mode: Indicator only or indicator with quantity.
  • Decimal precision: Number of decimal places for quantities (default: 2).

For configuration details, see Install the Product Availability Display feature.

Use cases

Use this feature when:

  • Customers need to see stock quantities to plan purchases
  • Customers need to verify availability before ordering
  • Multiple merchants sell the same product and stock varies by merchant (marketplace scenarios)
  • Products are sold in measurement units and quantities need to display with units

Limitations

  • Reserved or allocated stock is not shown separately.
  • Backorder management and pre-orders are not supported.
  • Per-warehouse availability is not displayed to customers.
  • Restock notifications are not provided.
  • Inventory forecasting and expected restock dates are not shown.