Magento Limit Number of Products in Home page

Magento Limit Number of Products in Home page

August 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento Limit Number of Products in Home page

Limiting the Number of Products Displayed on Your Magento Homepage

As an experienced Magento developer, I often receive queries about customizing the homepage to display only a specific number of products from a certain category. In this post, we’ll explore how you can achieve this using a combination of CMS blocks and template overrides.

Understanding the Current Setup

Your current approach involves adding a catalog/product_list block directly into your home page content. This is a common starting point for many developers looking to display products on their homepage. However, it doesn’t inherently provide any built-in limits on the number of displayed items.

Let’s break down the code you’ve provided:

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

This block:

  • Points to the catalog/product_list block type,
  • Uses a category ID of 25 (which presumably contains the products you want to display),
  • Uses the default list.phtml template.

The Challenge: Limiting the Number of Products

The primary challenge lies in the fact that Magento doesn’t provide an easy way to limit the number of products within this block directly. The catalog/product_list block is designed to display all products from a specified category, and it doesn’t have built-in parameters for limiting the output.

The Solution: Overriding the Template

To achieve your goal, we’ll need to override the default template (list.phtml) and manually limit the number of products displayed. Here’s how you can do this:

  1. Create a new template file: In your theme directory (or a custom extension), create a new folder structure: app/design/frontend/[Your_Theme]/template/catalog/product/list.phtml.

  2. Copy the default template: Copy the contents from vendor/magento/module-catalog/view/frontend/templates/product/list.phtml into your newly created file.

  3. Add the limit functionality:

Update your custom list.phtml file as follows:

<?php
$collection = $block->getLoadedProductCollection();
$limit = 9;
if ($collection->getSize() > $limit) {
    $collection->setPageSize($limit);
}
?>

In this code:

  • We get the loaded product collection from the block.
  • Set a variable $limit to specify the number of products you want to display (in your case, 9).
  • If the size of the collection is greater than the limit, we set the pagination size to match the limit.
  1. Flush the cache and update the homepage: After saving the changes, flush your Magento cache and re-check your home page. You should now see only nine products from category ID 25 displayed.

Best Practices for Homepage Product Display

While this solution directly addresses your specific question, it’s important to consider some best practices for displaying products on your homepage:

  • Create a new category: Instead of using an existing category, create a new one specifically for the products you want to display. This provides better control over the product selection and improves performance.

  • Use CMS blocks strategically: Consider having separate CMS blocks for different sections of your homepage (e.g., featured products, bestsellers, etc.). This can help maintain a cleaner layout and make updates easier.

Conclusion

Limiting the number of products displayed on the Magento homepage involves overriding the default template and manually setting the pagination size. While this requires some development work, it’s a straightforward solution that allows you to maintain full control over your homepage layout.

Remember, customizing the homepage is a crucial step in creating a compelling online storefront. By leveraging Magento’s flexibility, you can create unique shopping experiences tailored to your target audience.

For more advanced techniques and best practices for Magento theme development, I recommend checking out our comprehensive guides at https://laravelcompany.com/magento-theme-development/.

Catalog Themes

Our network