How to display configurable product list with color swatches option in home page Magento?

How to display configurable product list with color swatches option in home page Magento?

August 7, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to display configurable product list with color swatches option in home page Magento?

Displaying Configurable Products with Color Swatches on Home Page in Magento

If you’re struggling to display configurable products with color swatches options on your Magento home page, you’ve come to the right place. In this guide, we’ll walk through a step-by-step approach to achieve this while using the RWD theme.

Understanding the Configuration

Before diving into the code, let’s understand why you might be facing this issue. The default configuration in the RWD theme displays color swatches only on category pages by using the catalog_product_list block. This is controlled by the layout XML file located at app/design/frontend/rwd/default/layout/catalog.xml.

The relevant portion of this file looks like this:

<block type="catalog/product_list" name="category_products" template="catalog/category/products.phtml">
    <action method="setCategoryId"><category_id><![CDATA[{$block.category.getId()}]></category_id></action>
</block>

As you can see, the catalog_product_list block is set to use the category’s ID. When you use this block outside of a category page (like on the home page), it doesn’t have access to the category ID, causing the color swatches feature to fail.

Modifying the Layout XML File

To fix this issue, we need to modify the layout XML file to use a different template for non-category pages. Here’s how you can do it:

  1. Open or create the app/design/frontend/rwd/default/layout/cms_index_index.xml file.
  2. Add the following code within the <layout> tags:
<reference name="content">
    <block type="catalog/product_list" name="homepage_products" template="catalog/category/products.phtml">
        <action method="setCategoryId"><category_id><![CDATA[0]]></category_id></action>
    </block>
</reference>

In this code:

  • We’re creating a new catalog_product_list block named homepage_products.
  • We’re setting the template to use catalog/category/products.phtml, which is the default template that includes color swatches.
  • We’re using 0 as the category ID, which essentially means “all products.”

Updating the CMS Block

Next, you need to reference this new block in your CMS block for the home page.

  1. In Magento Admin, navigate to Content > Pages and edit your homepage.
  2. Switch to the Design tab.
  3. Under Layout Updates, find the content area and add a new update with the following configuration:
  • Select type: Static Block
  • Block: homepage_products

Conclusion

After making these changes, clear your Magento cache and refresh your home page. You should now see your configurable products displayed with color swatches options, just like you expected!

Remember to always test your changes thoroughly before deploying them to a live environment.

If you’re looking for more advanced customization or if you encounter any issues, feel free to reach out to our Magento development services at Laravel Company. We specialize in Magento 2 development and can provide expert assistance with your e-commerce projects.

Catalog Themes Configuration Errors

Our network