Get products to display on custom Magento page

Get products to display on custom Magento page

September 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Get products to display on custom Magento page

Displaying Products on Custom Magento Pages: A Comprehensive Guide

If you’re facing challenges in displaying products on custom Magento pages, you’re not alone. This common issue can be frustrating for developers, but fear not! In this guide, we’ll walk through the steps to get your products to appear correctly.

Understanding the Core Issue

When using the suggested block code:

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

Many developers encounter an error message: “There are no products matching the selection.” This happens when Magento can’t find any products that match your specified criteria.

The Underlying Causes

  1. Lack of Product Assignment: Ensure your products are assigned to a specific store view in the Magento backend. Products must be visible and associated with the correct store to appear on the frontend.

  2. Cache and Indexing Issues: As you mentioned, reindexing and clearing cache are crucial prep steps before making product visibility changes. However, sometimes manual reindexing isn’t enough; consider using Magento’s command line for more thorough indexing:

    php bin/magento indexer:reindex
    
  3. Template Inheritance: The template file catalog/product/list.phtml must exist and be properly configured in your theme directory structure.

Step-by-Step Solution

Let’s dive into the exact steps to make sure your products appear on custom pages:

  1. Configure Your Custom Layout XML File

    Create a new layout update XML file, e.g., catalog_product_list.xml, inside your theme’s app/design/frontend/{vendor}/{theme}/layout directory. Add the following content:

    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/layout.xsd">
        <update handle="catalog_category_layered navigation"/>
        <referenceContainer name="content.aside.second.column">
            <block type="Magento\Catalog\Block\Product\ListToLoadProductsData" template="Magento_Catalog::product/list/toolbar.phtml"/>
        </referenceContainer>
    </page>
    
  2. Configure Your Custom PHP File

    Create a new PHP file, e.g., ListToLoadProductsData.php, inside your theme’s app/design/frontend/{vendor}/{theme}/Magento_Catalog/view/frontend/templates/product directory:

    <?php
    namespace {Vendor}\{Theme}\Block\Product;
    
    class ListToLoadProductsData extends \Magento\Catalog\Block\Product\ListToLoadProductsData
    {
        protected $_collection = null;
        protected $_productCollectionFactory;
    
        public function __construct(
            \Magento\Catalog\Model\ResourceModel\Product\CollectionFactory $productCollectionFactory,
            array $data = []
        ) {
            $this->_productCollectionFactory = $productCollectionFactory;
            parent::__construct($data);
        }
    
        public function getLoadedProductCollection()
        {
            if (is_null($this->_collection)) {
                $collection = $this->_productCollectionFactory->create();
                $collection->setVisibility(\Magento\Catalog\Model\Product\Visibility::VISIBILITY_BOTH)
                    ->addAttributeToSelect('*');
                return $collection;
            }
            return $this->_collection;
        }
    }
    
  3. Display Products on Your Custom Page

    Add the following content to your custom CMS page through the WYSIWYG editor:

    <referenceContainer name="content">
        <block type="{Vendor}\{Theme}\Block\Product\ListToLoadProductsData" template="Magento_Catalog::product/list.phtml"/>
    </referenceContainer>
    

Conclusion

Displaying products on custom Magento pages requires a systematic approach that covers product visibility settings, theme configuration, and proper layout updates. By following this comprehensive guide, you should now be able to successfully showcase your products on any desired page within your Magento store.

Remember, it’s essential to keep your Magento version up-to-date for optimal performance and security. If you’re looking to further enhance your e-commerce platform with additional customizations or integrations, don’t hesitate to reach out to the expert team at LaravelCompany, where we specialize in delivering top-notch Magento solutions tailored to your business needs.

Happy coding!

Catalog Cache Indexing Themes

Our network