Add "My Cart" to top.links magento in local.xml or checkout.xml?

Add "My Cart" to top.links magento in local.xml or checkout.xml?

September 9, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Add "My Cart" to top.links magento in local.xml or checkout.xml?

As an experienced Magento developer, I often receive queries regarding customizing the header links and cart functionality. In this post, we’ll address two key questions about adding the “My Cart” feature to your local.xml or checkout.xml files.

The addCartLink action you’ve tried in your local.xml is on the right track, but it needs to be added within the <action> tag of the top.links reference. Here’s how to do it correctly:

<reference name="root">
  <reference name="top.links">
    <action method="addCartLink"/>
  </reference>
</reference>

Before making this change, ensure you have a backup of your local.xml file. This adjustment should be placed within the <global> section of your XML.

The “My Cart” link in Magento is handled by the Mage_Cart_Block_Link class, which extends Mage_Page_Block_Template. The key method you’re interested in is addCartLink.

To customize this link or modify its behavior, you should consider overriding the appropriate block in your custom theme. This approach ensures that your changes remain intact even after updates to Magento core files.

Here’s a step-by-step guide:

  1. Create a new block file: In your custom theme directory (e.g., app/design/frontend/custom/theme/template), create a folder structure similar to the Magento core (if it doesn’t exist already). Inside this folder, create a new file named Mage_Cart_Block_Link.phtml.

  2. Copy and modify the content: Copy the contents of the core Mage/Cart/Block/Link.php file into your new block file.

  3. Override the necessary methods: You can override specific methods like addCartLink or getCartUrl to customize the link behavior or URL structure. For example, to add custom CSS classes to the “My Cart” link:

public function addCartLink()
{
    $count = $this->getcartHelper()->getSummaryCount();
    $url = $this->getCartUrl();

    if ($count == 0) {
        $this->setChild('toplink_cart', $this->createBlock('page/html_link')
            ->addData(array(
                'label' => Mage::helper('checkout')->__('My Cart'),
                'class' => 'top-link-cart',
                'title' => Mage::helper('checkout')->__('Your shopping cart is empty.'),
                'href'  => $url
        )));
    } else {
        $this->setChild('toplink_cart', $this->createBlock('page/html_link')
            ->addData(array(
                'label' => Mage::helper('checkout')->__("My Cart (%s)"),
                'class' => 'top-link-cart',
                'title' => Mage::helper('checkout')->__('Your shopping cart contains %s item(s).'),
                'href'  => $url
        )));
    }

    return $this;
}
  1. Flush the cache: After making changes, clear your Magento cache to ensure the new block is applied.

Remember, when working with XML files like local.xml or checkout.xml, it’s crucial to backup your original files before making any modifications. This practice will help you quickly revert to a stable state if something goes wrong during the development process.

Conclusion

In this post, we’ve explored how to add the “My Cart” link to top.links in Magento using local.xml or checkout.xml files and provided a detailed guide on overriding the Mage_Cart_Block_Link class for customization. By following these best practices and leveraging your theme’s block override capabilities, you can seamlessly integrate the My Cart feature into your custom header without breaking core functionality.

Don’t forget to check out our Magento development services at Laravel Company for professional assistance with Magento e-commerce solutions.

Checkout API Themes Configuration

Our network