Display categories on home page in Magento

Display categories on home page in Magento

July 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Display categories on home page in Magento

Displaying All Categories on the Magento Home Page

Magento offers enormous flexibility for managing product categories and displaying them across your e-commerce store. As a newbie developer, you might find it challenging to showcase all categories directly on the home page instead of the default navigation menu. In this post, I’ll guide you through the process of implementing category display on the Magento front page.

Prerequisites

Before proceeding, ensure that you have a basic understanding of XML layout updates in Magento and are comfortable with editing templates. If not, I recommend checking out our article on Modifying Layouts in Magento to get started.

Step 1: Access the homepage template

The home page in Magento is controlled by the cms_index_index.xml layout file. To access it:

  • Navigate to your Magento installation’s root directory.
  • Locate the app/design/frontend/<your_package>/<your_theme> folder.
  • Open the layout.xml file and look for the following code:
<reference name="root">
  <action method="setTemplate">
    <template>page/cms-index-index.phtml</template>
  </action>
</reference>

The <template> line points to the CMS index template file.

Step 2: Modify the homepage template

Now that you know where the home page layout is defined, let’s modify it:

  • Open app/design/frontend/<your_package>/<your_theme>/template/page/cms-index-index.phtml.
  • Look for the content area where you want to display your categories. You can find it around line 47.
<div class="col-main">
    <div class="std">
        <?php echo $this->getLayout()->createBlock('cms/block')->toHtml(); ?>
    </div>
</div>

Step 3: Create a new block for categories

To display all categories, create a new block:

  • Open app/code/core/Mage/Cms/Block directory.
  • Copy the Block.php file and rename it to something like CategoryDisplay.php.
  • Modify the new PHP class as follows:
class Mage_Cms_Block_CategoryDisplay extends Mage_Core_Block_Template
{
    public function _toHtml()
    {
        $categories = Mage::getModel('catalog/category')->getCollection()->addFieldToFilter('is_active', 1)->addOrder('position', 'asc');
        return $this->getLayout()->createBlock('core/template')->setTemplate('path/to/your/customcategory.phtml')->setCategories($categories)->toHtml();
    }
}

This block retrieves all active categories and passes them to a custom template.

Step 4: Create the category display template

  • In your theme directory (app/design/frontend/<your_package>/<your_theme>), navigate into template/catalog/category.
  • Create a new file called customcategory.phtml.

Step 5: Design your category layout

Open customcategory.phtml and design your category display:

<?php if ($this->getCategories()): ?>
    <?php foreach ($this->getCategories() as $category): ?>
        <div class="category-block">
            <h3>
                <a href="<?php echo $this->getCategoryUrl($category) ?>">
                    <?php echo $this->escapeHtml($category->getName()) ?>
                </a>
            </h3>
            <!-- Add your category content here, e.g., images or descriptions -->
        </div>
    <?php endforeach; ?>
<?php endif; ?>

Step 6: Update the homepage XML layout

  • Go back to app/design/frontend/<your_package>/<your_theme>/layout.xml.
  • Add a new block reference:
<block type="cms/categorydisplay" name="category.display" template="catalog/category/customcategory.phtml">
    <action method="setCategoryId"><category_id>0</category_id></action>
    <reference name="content">
        <block type="cms/categorydisplay" name="category.display" template="catalog/category/customcategory.phtml">
            <action method="setCategoryId"><category_id>0</category_id></action>
            <reference name="root">
                <action method="addChild">
                    <type>Magento_Catalog_Block_Navigation</type>
                    <name>catalog.navigation</name>
                </action>
            </reference>
        </block>
    </reference>
</block>

Conclusion

By following these steps, you’ve successfully displayed all active categories on your Magento home page. Remember to refresh the cache if needed.

This technique provides a clean and efficient way of showcasing multiple product categories on a single page without cluttering up the navigation menu. It offers better visibility for your customers while keeping your store’s design organized.

For more advanced customization options, consider checking out our comprehensive guide on Magento 2 Theme Development.

Catalog Indexing Database Themes

Our network