show products on cms page under specified category id

show products on cms page under specified category id

August 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
show products on cms page under specified category id

Solving Product Display Issues on Magento CMS Pages

You’re encountering an issue when trying to display products under a specific category ID on your Magento CMS page. Let’s break down the problem and find a solution.

The Current Approach

Your current code uses Magento’s block system to render a product list:

{{block type="catalog/product_list" category_id="12" template="catalog/product/list.phtml"}}

This works on your homepage because it correctly references the list.phtml file for rendering the catalog products under category 12.

The Issue: Changing the Template

You attempted to create a new template file called listhp.phtml and use it instead:

{{block type="core/templatet" category_id="12"  template="catalog/product/listhp.phtml"}}

However, this resulted in no products being displayed. The key problem lies in the block type you’re using.

The Mistake: Incorrect Block Type

The core/templatet block type doesn’t exist in Magento out of the box. You likely intended to use a real block type such as catalog/product_list. To verify this, you can check the available blocks via the Magento backend:

  1. Log into your Magento admin panel.
  2. Navigate to “System” > “Layout XML File Editor”.
  3. Search for “catalog.product.list” in the search bar.

You’ll notice that catalog/product_list is a valid block type associated with product listing layouts.

The Correct Approach

To display products under category 12 using your custom template, you should use the correct block type and ensure the template path is correctly specified:

{{block type="catalog/product_list" category_id="12" template="catalog/product/listhp.phtml"}}

Make sure that:

  • The listhp.phtml file exists in your theme’s catalog/product directory.
  • You have permission to read and display files from this location.

Best Practices

For better control over your product lists, consider the following:

  1. Use Layout XML: Instead of using inline block calls, create a new layout XML file (e.g., catalog_product_list_category_12.xml) under app/design/frontend/<vendor>/<theme>/Magento_Catalog/layout. This allows you to specify additional settings like template files.
<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="catalog_product_list" />
    <referenceBlock name="catalog.product.list" template="Catalog/Product/listhp.phtml"/>
</page>
  1. Reference the Layout XML: In your CMS page, reference this new layout file:
{{layout area="frontend" template="catalog_product_list_category_12.xml"}}

Conclusion

To display products under a specific category on Magento CMS pages, you need to use the correct block type and ensure that the template path is valid. I recommend using layout XML files for better control over your product lists.

Remember, when dealing with template changes, always back up your original files first. This way, if something goes wrong, you can easily restore the default behavior.

For more information on Magento’s CMS page customization and layout reference guides, check out our detailed tutorials at Laravel Company.

Catalog Themes Admin Errors

Our network