After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Stock Message Scenarios

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

You can use a combination of configuration settings to control stock availability messages on product pages and in listings of products on catalog pages.

Grouped Product with “Out of Stock” Message

Product page stock messages

There are several variations of messaging available for the product page, depending on the combination of Manage Stock and Stock Availability settings.

Example 1: Show availability message

Scenario 1

This combination of settings causes the availability message to appear on the product page, according to the stock availability of each product.

Stock Options Setting Message
Display product availability in stock in the frontend: Yes  
Manage Stock Yes  
Stock Availability In Stock “Availability: In Stock”
  Out of Stock “Availability: Out of Stock”

Scenario 2

When stock is not managed for a product, this combination of settings can be used to display the availability message on the product page.

Stock Options Setting Message
Display product availability in stock in the frontend: Yes  
Manage Stock No “Availability: In Stock”

Example 2: Hide availability message

Scenario 1

This combination of configuration and product settings prevents the availability message from appearing on the product page.

Stock Options Setting Message
Display product availability in stock in the frontend: No  
Manage Stock Yes  
Stock Availability In Stock None
  Out of Stock None

Scenario 2

When stock is not managed for a product, this combination of configuration and product settings prevents the availability message from appearing on the product page.

Stock Options Setting Message
Display product availability in stock in the frontend: No  
Manage Stock No None

Catalog page stock messages

The following display options are possible for the category and search results lists, depending on the product availability and configuration settings.

“Out of Stock” Message on Category Page

Example 1: Show product with “Out of stock” message

This combination of configuration settings includes out of stock products in the category and search results lists, and displays an “out of stock” message.

Stock Options Setting Message
Display Out of Stock Products Yes  
Display product availability in stock in the frontend Yes “Out of stock”
Display Out of Stock Products Yes  
Display product availability in stock in the frontend No None

Example 2: Show product without “Out of stock” message

This combination of configuration settings includes out of stock products in the category and search results lists, but does not display a message.

Stock Options Setting Message
Display Out of Stock Products Yes None
Display product availability in stock in the frontend No  

Example 3: Hide product until back in stock

This configuration setting omits out of stock products entirely from the category and search results lists, until they are back in stock.

Stock Options Setting Message
Display Out of Stock Products No None