Magento recently viewed products

Magento recently viewed products

October 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento recently viewed products

Solving Magento Recently Viewed Products Issue

Introduction

In this post, we’ll address a common issue encountered by Magento developers - retrieving and displaying recently viewed products correctly in the frontend.

The Current Setup and Challenges

The developer tried two main approaches:

  1. Directly fetching the recently viewed product collection using Mage::getSingleton('Mage_Reports_Block_Product_Viewed')->getItemsCollection();. However, this failed to return any data.

  2. Attempting to include the default recently viewed products block in their local.xml layout file and calling it from view.phtml using $this->getChildHtml('product_recently_viewed');. Despite having records in the MySQL table for last viewed products, nothing was displayed on the frontend.

Common Mistakes and Their Causes

1. Incorrect Collection Fetching

The direct fetching approach often fails due to:

  • Version Incompatibility: The Mage_Reports_Block_Product_Viewed class might not exist in your specific version of Magento.
  • Caching Issues: The data may be cached and not refreshed properly.

2. Layout Update Errors

The issue with the layout update might stem from:

  • Incorrect XML Namespace: Ensure you’re using the correct namespace for layout updates, e.g., catalog_product_view instead of a custom namespace.
  • Reference Name Conflicts: Double-check that there are no conflicts between the reference names used in your layout update and any existing ones.

The Correct Approach: Using Block Class

To correctly display recently viewed products, we recommend using the built-in block class:

  1. In your view.phtml file or other template where you want to display the recently viewed products, include the following line:
<?php echo $this->getChildHtml('product_recently_viewed'); ?>
  1. Ensure your layout XML includes the appropriate block declaration within the correct parent reference (usually content for most product pages):
<catalog_product_view>
    <reference name="content">
        <block type="reports/product_viewed" name="product.recently.viewed" as="product_recently_viewed" template="reports/product_viewed.phtml"/>
    </reference>
</catalog_product_view>
  1. Make sure the product is actually viewed and recorded in the report_event table before expecting it to appear in the recently viewed list.

Best Practices for Handling Recently Viewed Products

  • Flush Caches: After making changes, always flush your Magento cache types (cache_flush all).

  • Use Controller Actions: If you’re developing a custom module or extension that needs to track views, consider using controller actions to update the report_event table directly.

Conclusion and Next Steps

In most cases, the issues arise from incorrect XML layout updates or version-specific changes in Magento. Always ensure you’re working with compatible versions of the platform and refer to official documentation when handling built-in features like recently viewed products.

For more advanced customizations or if you’re facing further challenges, I recommend exploring our comprehensive guides on Magento extension development at Laravel Company.

Catalog Cache Database Themes

Our network