First, make sure the Discounts section on the home page is implemented.

The Frontpage Discounts section requires two separate components: a list of discounted products that is generated in the background, and a storefront component that displays the list. The DISPLAY_DISCOUNTED_FRONT_PRODUCTS setting only controls how the list is generated. Enabling this setting does not add a new section to the default frontpage or change the structure of the current frontpage.

Only enable the setting if a product purchase using this discounts list has already been implemented on the store's homepage or is being implemented at the same time. If the section is missing, first agree on its title, placement, appearance, link, and behavior on different screen sizes. Without a visible component, the list formed in the background will not be visible to the customer, even if the setting is enabled.

Enable the sale list in Configurations

The front page discount list is enabled in the Configurations view of the administration at /configuration . Find the setting with the technical identifier DISPLAY_DISCOUNTED_FRONT_PRODUCTS , open the edit, change the value to Enabled and save the change. Use the identifier to search so that the setting does not get mixed up with other product purchases on the front page.

Also, check the FRONT_PAGE_RECOMMENDATIONS_LIMIT setting. It also sets the maximum number of purchases for the Discounts list, just like other product purchases on the front page. Do not change the number just for the Discounts section without evaluating the impact on other recommendation lists. If the setting is not found or the save is not available, do not replace it with another similar setting.

Check which products make it to the Discounts list

Only products with Usage Status set to On and product type not hidden are selected for the Discounts list on the home page. The product must have a real price reduction: the original price products_price_original must be greater than the current price products_price . A mere discount text, volume discount, or other promotion does not meet this selection criterion unless there is a required difference between the two prices of the product.

Eligible products are ordered by discount score. The score is the sum of the discount amount and the relative discount, so both the euro and percentage benefits affect the order. The list length is limited by the FRONT_PAGE_RECOMMENDATIONS_LIMIT setting. If the expected product is missing, first check the Usage Status, hidden product type, and the ratio of the original to the current price.

Check the result in the storefront

After implementing the Discounts list on the homepage, verify both the background data and the section visible to the customer. Open the homepage in a private browser window, check the visibility of the section, the number and order of products, and open a few products to make sure the prices and links are correct. Also, check that no hidden or Inactive products are visible in the list.

The default front page does not currently automatically add discounts , and the Recommendations Carousel on the Builder.io page only supports arrivals , trending , and ranking types. Therefore, successfully saving the setting and having a list in the background does not yet prove that the Discounts section is visible to the customer. If the store's standalone implementation does not show the list, open Support → Create a support request and include the store, homepage address, setting value, and an image of the expected placement.