Related Products - What am I doing wrong? (they're not showing up in sidebar!)

Related Products - What am I doing wrong? (they're not showing up in sidebar!)

September 11, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Related Products - What am I doing wrong? (they're not showing up in sidebar!)

Troubleshooting Related Products Not Displaying

Hello Bill,

Thank you for reaching out regarding the issue of related products not displaying on your store pages. I’ll guide you through troubleshooting this problem step-by-step.

Checking the Configuration

First, let’s ensure that the basic configuration is correct:

  1. Enable the modules: Log into your admin panel and navigate to Stores > Settings > Configuration. Under the Sales section, make sure the following options are enabled:

    • Display Cross-Sell Products
    • Display Related Products
    • Display Up-Sell Products
  2. Check product assignment: Go to Catalog > Products and select a product that should have related products assigned. In the “Related Products” tab, ensure you’ve added at least one product as a related item.

If both these steps are correct but the issue persists, let’s dive deeper into potential causes.

Debugging the Sidebar

The sidebar where related products should display is controlled by Magento’s layout XML files and block configuration. Here are some things to check:

Layout Update XML

Open app/design/frontend/<your_theme>/layout/local.xml (create it if doesn’t exist) and add or update this code within <default> tags:

<block type="catalog/product_list_related" name="product.related" as="related_products" template="catalog/product/list.phtml"/>

Make sure the “template” attribute points to the correct file location.

Block Configuration

Next, in app/code/core/Mage/Catalog/Block/Product/List/Related.php, check if the block is being initialized correctly:

public function getProducts()
{
    // This method should return related products
}

If this isn’t returning any results, there might be an issue with the database or product associations.

Database and Product Assignment

Ensure that:

  • The “related_link_table” in your database has correct records for each product.
  • The “product_sku” field is populated accurately.
  • There are no syntax errors in your SQL queries related to these tables.

Remember, related products are linked via the catalog_product_link table. Each row should contain a valid product_id and linked_product_id.

Clearing Cache

If all else fails, clear your cache by running:

php bin/magento cache:clean

Then check if the issue is resolved.

Conclusion

In most cases, ensuring that the modules are enabled, the layout XML is configured correctly, and there’s accurate data in the related products table should solve the problem. If you’re still facing issues after following these steps, please let me know so we can look into it further.

For more advanced customizations or if you need professional help, feel free to contact our team at Laravel Company. We specialize in Magento development and would be happy to assist with your store’s needs.

Happy coding!

Catalog Extensions Themes Admin

Our network