Change template page layout on cart page in Magento

Change template page layout on cart page in Magento

August 21, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Change template page layout on cart page in Magento

Changing Template Page Layout for Cart Page in Magento

Introduction

Magento is a powerful e-commerce platform that allows you to customize your storefront extensively, including changing the layout of specific pages like the cart page. In this guide, we’ll walk through the steps required to modify the template page layout of the cart page so it matches the style of other category pages in your Magento store.

Understanding Magento Layout Structure

Before diving into the code changes, let’s first understand how Magento handles layouts:

  1. Default Layout: Magento uses a default page layout file located at app/design/frontend/{package}/{theme}/layout/page.xml. This file defines the base structure for all pages in your theme.

  2. Page-specific Layouts: For specific pages like the cart, Magento uses a dedicated layout file called checkout_cart_index.xml, which is found within the same directory as page.xml but with a more specific name.

  3. Layout Handles: These are identifiers that link a layout update to a specific page or action in Magento. The default layout handle for the cart page is checkout_cart_index.

Step-by-Step Guide: Changing Cart Page Layout

1. Identify the Current Layout Structure

First, open the app/design/frontend/{package}/{theme}/layout/checkout_cart_index.xml file on your machine or directly in your FTP client.

You should see a structure similar to this:

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="catalog_category_layered"/>
    <referenceContainer name="content">
        <block class="Magento\Checkout\Block\Cart" template="cart.phtml" name="checkout.cart.items" cacheable="false"/>
    </referenceContainer>
</page>

2. Copy the Layout File

To avoid losing your changes, we’ll first create a copy of this file in the local theme directory (not the base package). Duplicate your app/design/frontend/{package}/{theme}/layout/checkout_cart_index.xml and save it as app/design/frontend/{package}/{theme}/layout/local/checkout_cart_index.xml.

3. Modify the Layout File

Open the new local/checkout_cart_index.xml file you just created:

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="catalog_category_layered"/>
    <referenceContainer name="content">
        <block class="Magento\Checkout\Block\Cart" template="custom_cart.phtml" name="checkout.cart.items" cacheable="false"/>
    </referenceContainer>
</page>

Here, we’re making two changes:

  • We’ve removed the update handle line for catalog_category_layered. This removes the layered navigation feature from the cart page.

  • We’ve changed the template to custom_cart.phtml, which is a new file you’ll need to create in your theme directory: app/design/frontend/{package}/{theme}/Magento_Theme/templates. The contents of this file should be identical to the cart.phtml file found in the base Magento Theme path, but with any necessary customizations.

4. Save and Deploy

Save the changes, upload them back to your server (overwriting the existing files), and clear the cache using the command line:

php bin/magento cache:flush

Conclusion

In this guide, we’ve demonstrated how to change the layout of the cart page in Magento by modifying specific layout XML files. While our example focuses on the Magento Cart block, you can apply similar principles to any other page or block within your store.

Remember, theme customization is a powerful feature but requires careful testing and version control management. Always create backups before making significant changes and consider using a staging environment for testing prior to deployment.

For more advanced layout customizations and best practices in Magento development, be sure to explore the Laravel Company Blog.

Checkout Catalog Themes CLI

Our network