Magento 2 Porto Theme Move Category Description Below Products

Magento 2 Porto Theme Move Category Description Below Products

September 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 Porto Theme Move Category Description Below Products

Solving Category Description Placement Issues in Magento 2 Porto Theme

Are you facing difficulties arranging your category description below the product listings on your Magento 2 website using the Porto theme? You’re not alone. Many Magento developers struggle with this layout issue, which often requires a deep dive into the theme’s XML layouts and template files.

In your case, you’ve already identified that the category banner and description are being rendered in incorrect positions within the page structure. Let me guide you through the process of rectifying this issue by manipulating the Porto theme’s layout XML file.

Understanding the Current Layout Structure

The provided layout XML file is responsible for defining how various blocks are positioned on your category product listing pages. Here’s a breakdown of the critical elements:

  • <referenceContainer name="page.top">: This container holds header-related content.
  • <block class="Magento\Catalog\Block\Category\View" name="category_banner"...>: The category banner is placed at the top of the page before the main container.
  • <referenceContainer name="content">: The main container for primary content, where product listings are typically displayed.
    • <block class="Magento\Catalog\Block\Category\View" name="category_desc_main_column"...>: The category description block is placed here, but it’s being positioned before the products by default.

Rearranging the Category Description

To move the category description below the product list, we need to adjust the layout XML file as follows:

<referenceContainer name="content">
    <block class="Magento\Catalog\Block\Category\View" name="category_desc_main_column" template="category/desc_main_column.phtml" ifconfig="porto_settings/category/category_description" before="category.products"/><-- ADJUST THIS LINE -->
</referenceContainer>

The key change here is the addition of the before attribute set to "category.products". This instruction tells Magento to place the category description block immediately before the product list block named category.products.

Additional Considerations

While this adjustment should resolve your primary issue, it’s essential to consider a few other factors:

  1. Template Structure: Ensure that your category description template (desc_main_column.phtml) is correctly structured and includes the necessary HTML and CSS for proper rendering.

  2. CSS Styling: Check if the Porto theme’s stylesheets contain any rules that might be interfering with the positioning of your category description block. You may need to override or adjust these styles to achieve your desired layout.

  3. Performance: Remember that modifying core Magento files like this XML layout can potentially impact performance and upgrade compatibility. Always maintain a backup before making such changes.

Conclusion

Reorganizing element positions in Magento 2 themes often requires navigating the complex world of XML layouts and template structures. By understanding the existing layout structure and applying targeted adjustments, you’ve successfully moved your category description below the product listings on your Porto theme-powered store.

If you find yourself needing more advanced customizations or facing other development challenges, be sure to explore the comprehensive resources available at Laravel Company. Our expert blog posts, tutorials, and guides provide the insight needed to master Magento 2 development with confidence.

Magento 2 Catalog Themes Errors

Our network