CMS page with layered navigation not working

CMS page with layered navigation not working

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
CMS page with layered navigation not working

Fixing Layered Navigation on Magento CMS Pages

If you’re having trouble getting layered navigation to work correctly within your custom CMS page in Magento, you’ve come to the right place. Let’s troubleshoot this issue step-by-step.

Understanding the Problem

You’re trying to display all products from a specific category (let’s say “All Products”) on a CMS page with a left sidebar using the catalog/product_list block. You’ve set up your layout and content tabs correctly, but the layered navigation isn’t appearing as expected.

What’s Going Wrong?

The issue likely lies in the way Magento handles layered navigation and its integration with CMS pages by default. When you use the standard catalog/product_list block, it doesn’t automatically include the layered navigation elements like filters and price sliders that you expect.

The Missing Piece

To make layered navigation work within your CMS page, you need to include the relevant blocks from the catalog/layer template group in addition to your product list. This ensures Magento loads all the necessary components for filtering and sorting products.

The Solution: Add Required Blocks

Here’s how to modify your CMS page content code:

{{block type="core/template" name="catalog.layer.view" as="layer_view"}}
{{block type="core/template" name="catalog.topnav" template="page/html/topmenu.phtml"}} 
{{block type="catalog/product_list" category_id="2" template="catalog/product/list.phtml"}}

<script type="text/javascript">
    //<![CDATA[
        var configSlider = new ConfigurableSlider('product-collection', 'price');
        configSlider.init();
    //]]>
</script>

Let’s break down what we’ve added:

  • We’re including the catalog.layer.view block, which is responsible for rendering layered navigation elements like filters and sliders.
  • The catalog.topnav block renders the top menu for your site. This ensures that all necessary navigation links are present.
  • Finally, we’re adding a JavaScript snippet to initialize the ConfigurableSlider object, which powers the price slider in layered navigation.

Why This Works

By including these additional blocks and scripts, you’re providing Magento with everything it needs to render the layered navigation components within your CMS page. The catalog.layer.view block handles the filtering logic, while the JavaScript snippet ensures that interactive elements like the price slider function correctly.

Best Practices for Layered Navigation on CMS Pages

Here are a few tips to keep in mind:

  1. Always use unique names for your blocks to avoid conflicts.
  2. Ensure that your category ID matches an existing category in Magento.
  3. Test your layered navigation functionality thoroughly to ensure all filters and sliders work as expected.
  4. Consider using the catalog_category_view block if you want a more integrated, category-specific CMS page experience.

Conclusion

Fixing layered navigation on Magento CMS pages requires a bit of finesse with block inclusions and scripts. By following our solution guide, you should now be able to display layered navigation components within your custom CMS page seamlessly.

Remember, the key is to provide Magento with all the necessary blocks and scripts it needs to render layered navigation elements correctly within your custom layout.

For more detailed guides on working with Magento CMS pages and layered navigation, check out our comprehensive tutorials at Laravel Company.

Catalog Themes Pricing Errors

Our network