Show pagination links for product list on a Magento CMS page

Show pagination links for product list on a Magento CMS page

July 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Show pagination links for product list on a Magento CMS page

Showing Pagination Links for Product List on a Magento CMS Page

As a developer, I often encounter scenarios where we need to display products from specific categories within a custom Magento CMS page while preserving pagination functionality. In your case, you’ve already set up a block to display products from category ID 3, but the paginator is missing in the CMS page context.

Let’s investigate this issue and find a solution that works seamlessly with your current setup.

Understanding the Block Configuration

The code snippet you provided creates a new block of type “catalog/product_list” named “home.catalog.product.list”. This block is linked to an alias “products_homepage” and uses the category with ID 3 as its data source. The template specified is “catalog/product/list.phtml”, which is Magento’s default product list view.

{{block type="catalog/product_list"
     name="home.catalog.product.list"
     alias="products_homepage"
     category_id="3"
     template="catalog/product/list.phtml"}}

The Missing Paginator

By default, when you use a block of type “catalog/product_list”, the paginator is automatically included in the layout file associated with the chosen template. However, there seems to be an issue when using this block within a CMS page.

The Cause of the Problem

The paginator relies on certain layout elements and blocks that are not automatically added when you place a product list block inside a CMS page. Specifically, it requires the “toolbar” handle in your layout XML file.

Solving the Pagination Issue

To resolve this problem, we need to add the required layout update for the paginator within our CMS page template. Here’s how to do it:

  1. Locate your custom CMS page template (e.g., “yourtheme/page/your_page.phtml”).

  2. Identify where you have placed the block code provided earlier.

  3. Just before or after this block, add the following layout update XML snippet:

<update handle="catalog_product_list_toolbar"/>

This will ensure that the necessary layout elements for the paginator are included when rendering your CMS page.

An Example Implementation

Let’s assume you have a custom template called “yourtheme/page/your_page.phtml”. Your current code might look like this:

<!-- Other CMS content here -->

{{block type="catalog/product_list" name="home.catalog.product.list"
     alias="products_homepage"
     category_id="3"
     template="catalog/product/list.phtml"}}

<!-- Other CMS content here -->

You need to add the layout update handle just before or after the block code:

<!-- Other CMS content here -->

<update handle="catalog_product_list_toolbar"/>

{{block type="catalog/product_list" name="home.catalog.product.list"
     alias="products_homepage"
     category_id="3"
     template="catalog/product/list.phtml"}}

<!-- Other CMS content here -->

Testing the Solution

After making this change, save your template and visit or refresh your CMS page. You should now see the paginator links appearing below the product list, allowing you to navigate through 9 products per page as configured in your Magento settings.

Conclusion

In conclusion, displaying pagination for a product list within a custom Magento CMS page requires adding the necessary layout update handle (“catalog_product_list_toolbar”) to ensure that the paginator elements are included. This solution preserves the existing block configuration while enhancing the user experience by providing proper navigation through multiple pages of products.

Remember, when working with Magento, understanding the relationship between templates and layout updates is crucial for creating fully functional custom CMS content.

For more detailed information on customizing Magento CMS pages and handling product lists effectively, consider exploring our comprehensive guides at Laravel Company. We provide in-depth tutorials and best practices to help you maximize the potential of your Magento platform.

Catalog Themes Configuration Errors

Our network