PrestaShop Guides

PrestaShop Homepage Troubleshooting: Fix New, Featured & Best-Selling Products Not Showing

One of the most common frustrations for new PrestaShop store owners, or even seasoned merchants adding new product lines, is when their carefully curated products simply refuse to appear on the store's homepage. This often manifests with core modules like "New Products," "Featured Products," and "Best Sellers" remaining stubbornly empty. As e-commerce migration experts at Migrate My Shop, we frequently encounter these scenarios, and a recent PrestaShop forum thread (Thread #1110924) perfectly illustrates this challenge, offering valuable insights and practical solutions, especially for those working with PrestaShop 9.1.4 and the classic theme.

PrestaShop homepage blocks for New, Featured, and Best-Selling Products, successfully displaying items.
PrestaShop homepage blocks for New, Featured, and Best-Selling Products, successfully displaying items.

The Initial Problem: Empty Homepage Blocks

The forum thread author, YannT, was in the process of setting up a new PrestaShop 9.1.4 store using the classic theme. Despite creating products, the "produits phares" (Featured Products), "meilleures vente" (Best Sellers), and "nouveaux produits" (New Products) modules on the homepage were not displaying any items. YannT specifically noted that these were dematerialized products and wondered if characteristics like stock quantity might be blocking their visibility. A preliminary check confirmed that the "number of days for new products" setting was correctly configured to 20 days, indicating the issue wasn't a simple time-based display limit.

Community-Driven Troubleshooting Steps & Solutions

The PrestaShop community quickly jumped in with helpful suggestions, leading to a comprehensive understanding of the various factors at play for each module.

1. Troubleshooting the "New Products" Module

The "New Products" module is designed to showcase your latest additions. If it's empty, here's what to check:

  • Product Status: The "Online" Option is Key: Alexandre Carette's initial advice pointed to checking if products are marked as "new." While there isn't an explicit "new" checkbox in PrestaShop 9.1.4's product options, YannT discovered the crucial setting: the "En ligne" (Online) option. This simple toggle, usually found near the product name or status, must be activated for the product to be visible on the front office, including in the "New Products" block. Without it, the product remains a draft.
  • Module Activation & Configuration: Even if products are online, the module itself must be active and correctly configured. Navigate to Modules > Module Manager, search for "New Products" (or "Nouveaux produits"), ensure it's enabled, and check its configuration. This is where you set the number of products to display and the number of days a product is considered "new." YannT had already confirmed the 20-day setting, which was correct.
  • Stock Quantity for Dematerialized Products: YannT's products were dematerialized (digital). While stock quantity might seem irrelevant for digital goods, some PrestaShop themes or configurations might implicitly filter out products considered "out of stock." As a best practice, especially during initial setup, setting a high stock quantity (e.g., 1000) for dematerialized products can circumvent any unintended stock-related display blocks. YannT's resolution confirmed this, stating, "J'ai mis un stock à 1000 partout (cette notion est peu pertinente pour un produit dématérialisé de toutes façon) C'est résolu."

2. Troubleshooting the "Featured Products" Module

The "Featured Products" module (often called "Produits phares" or "Home page products") displays products from a specific category, usually the "Home" category by default.

  • Category Association is Crucial: As Knowband Plugins rightly pointed out, for a product to appear in the "Featured Products" block, it must be associated with the category defined in the module's configuration. By default, this is often the "Home" category (ID 2).
  • How to Check and Configure:
    1. Go to Modules > Module Manager and find the "Featured Products" module.
    2. Click "Configure."
    3. Verify which category is selected for display. It's typically "Home" or "Accueil."
    4. Now, for each product you want to feature, go to its product page in the back office.
    5. Under the "Associations" tab, ensure the correct category (e.g., "Home") is checked.

3. Troubleshooting the "Best Sellers" Module

The "Best Sellers" module is unique because its content is dynamically generated based on actual sales data.

  • Requires Real Sales Data: Knowband Plugins clarified this perfectly: "Meilleures ventes se base sur les ventes réelles : le bloc reste vide tant que la boutique n'a pas encore de commandes." This means the "Best Sellers" block will remain empty until your store processes actual orders. It's a performance indicator, not a manually populated list.
  • Patience is a Virtue: If your store is new, this module will populate itself naturally as customers make purchases. There's no manual configuration to add products here directly.

General PrestaShop Homepage Troubleshooting Tips

Beyond module-specific issues, consider these general PrestaShop best practices:

  • Clear Cache: Always clear your PrestaShop cache after making significant changes. Go to Advanced Parameters > Performance and click "Clear cache." Smarty cache can sometimes hold onto old display states.
  • Check Module Positions: Ensure the modules are hooked to the correct display positions (e.g., displayHome) in your theme. You can check this under Design > Positions.
  • Enable Debug Mode: If problems persist, enable debug mode (Advanced Parameters > Performance > Debug mode) to reveal any PHP errors that might be preventing module rendering.
  • Theme Compatibility: While YannT used the classic theme, custom themes can sometimes have their own display logic or conflicts. Ensure your theme is compatible with your PrestaShop version.
  • Product Visibility Settings: Double-check the overall product visibility settings on the product page (e.g., "Everywhere," "Catalog only," "Search results only").
// Example of checking module hook in Smarty template (for developers)// This snippet would be in your theme's home.tpl or index.tpl{hook h='displayHome'} // Ensure your module is hooked to 'displayHome' via Design > Positions

Conclusion: Your Products, Front and Center

Ensuring your products are prominently displayed on your PrestaShop homepage is vital for conversions. As this forum thread illustrates, the solutions are often straightforward but require a systematic approach to troubleshooting. From activating the "Online" status for new products to associating items with the correct categories for featured blocks, and understanding the sales-driven nature of best sellers, these steps will help you get your products front and center.

At Migrate My Shop, we understand that setting up and optimizing an e-commerce store can be complex. Whether you're migrating from an older PrestaShop version, another platform, or simply need expert assistance with your current setup, our team is here to ensure your store runs smoothly and your products shine. Don't let display issues hinder your sales – reach out to us for comprehensive PrestaShop support and migration services!

Share:

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools