Moving Magento "Add to Cart" button to new file not working

Moving Magento "Add to Cart" button to new file not working

August 27, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Moving Magento "Add to Cart" button to new file not working

Moving Magento “Add to Cart” Button: A Comprehensive Guide

Are you trying to relocate the Magento “Add to Cart” button from its default location? You’re not alone! In this post, we’ll explore how to move this essential element to a new file within your theme.

Understanding the Magento Template Structure

Before diving into the code, let’s quickly review the Magento template structure. Templates are located under app/design/frontend/<vendor>/<theme>/template/catalog/product/view.phtml. The default “Add to Cart” button is placed inside this file.

Moving the “Add to Cart” Button: Step-by-Step

1. Create a New File

First, you need to create a new template file where you want to move the “Add to Cart” button. For example, if you want to place it in 2columns-right.phtml, make sure this file exists under:

app/design/frontend/<vendor>/<theme>/template/catalog/product/list.phtml

2. Copy the Relevant Code

Next, copy the relevant code block from view.phtml to your new file. Here’s what you need to look for in view.phtml:

<div class="actions">
    <?php if($_product->is Saleable() && $this->helper('catalog.Output')->productAttributeIsVisible($_product, $_product->getTypeId(), $_product->getId(), 'addtocart')):?>
        <button type="button" title="<?php echo $this->__('Add to Cart') ?>" class="button btn-cart" onclick="setLocation('<?php echo $this->getAddToCartUrl($_product) ?>')"><span><span><?php echo $this->__('Add to Cart') ?></span></span></button>
    <?php else:?>
        <p class="availability out-of-stock"><?php echo $this->__('Out of stock') ?></p>
    <?php endif; ?>
</div>

Copy and paste this entire block into your new file.

3. Update the Layout XML

Now, let’s update the layout XML to ensure Magento renders the “Add to Cart” button in the correct place. Open app/design/frontend/<vendor>/<theme>/layout/catalog.xml and add or modify the following code:

<reference name="content">
    <block type="catalog/product_view" template="catalog/product/view.phtml" after="cms_page"/>
</reference>

Change the template attribute to match your new file. For example, if you’re using a custom file named custom-view.phtml, update it like this:

<reference name="content">
    <block type="catalog/product_view" template="catalog/product/custom-view.phtml" after="cms_page"/>
</reference>

4. Flush the Cache

Finally, don’t forget to flush your Magento cache from the admin panel (System > Cache Management) or via SSH with the following command:

php bin/magento cache:flush

Troubleshooting Common Issues

If you’re still having trouble, double-check these common issues:

  • Ensure that you’ve updated both the template file and the layout XML.
  • Verify that your theme is enabled in the admin panel (Content > Design > Configuration).
  • Check if any other extensions are overriding your template files.

Remember to always backup your data before making changes to your Magento installation. If you need further assistance, feel free to explore our Magento development services at Laravel Company.

Conclusion

Moving the “Add to Cart” button in Magento requires a solid understanding of the theme structure and layout. By following this guide, you should now be able to relocate this critical element with ease. Don’t hesitate to reach out if you have any additional questions or need expert guidance for your e-commerce projects.

Happy coding!

Checkout Catalog Themes Errors

Our network