Magento replace add to cart button with image

Magento replace add to cart button with image

October 19, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento replace add to cart button with image

Replacing the Magento “Add to Cart” Button with a Custom Image

Magento’s default “Add to Cart” button can be replaced with a custom image for a more unique and visually appealing user experience on your storefront. This tutorial will guide you through the process of replacing this button with an image of your choice.

Step 1: Prepare Your Image File

First, ensure your image file is ready. The recommended size for the “Add to Cart” button is around 200x50 pixels, but you can adjust it according to your design requirements. Save the image as a PNG or JPEG format and name it something descriptive, like “add-to-cart-button.png”.

Step 2: Upload Your Image

Upload this image file to your Magento theme folder. The default path for your theme is app/design/frontend/[vendor]/[theme]. Within this folder, create a new directory called “web” if it doesn’t exist already:

app/design/frontend/[vendor]/[theme]/web

Place the “add-to-cart-button.png” file inside the “images” subdirectory of the “web” folder.

Step 3: Update Your Template File

Next, you’ll need to update the catalog_product_view.xml layout file in your theme. Open this file and locate the following XML node:

<block class="Magento\Catalog\Block\Product\View" name="product.info.addto">
    <action method="setTemplate">
        <argument name="template" xsi:type="string">Magento_Catalog::product/view/addto.phtml</argument>
    </action>
</block>

Replace the template argument with the following:

<argument name="template" xsi:type="string">Magento_Theme::template/your-theme-name/html/product/view/add-to-cart-button.phtml</argument>

Make sure to replace [your-theme-name] with the actual name of your theme.

Step 4: Create the Custom Template File

Create a new file named add-to-cart-button.phtml inside the following folder:

app/design/frontend/[vendor]/[theme]/Magento_Theme/templates/html

Inside this new file, add the following PHP code to display your custom image button:

<?php if ($_product = $block->getProduct()): ?>
    <div class="add-to-cart-button">
        <a href="<?= $block->getAddToCartUrl($_product) ?>" class="action-tocart" onclick="setLocation('<?= $this->escapeHtml($_product->getAddToCartUrl()) ?>')">
            <img src="<?= $block->getViewFileUrl('images/add-to-cart-button.png') ?>" alt="<?= /* @noEscape */ __('Add to Cart') ?>">
        </a>
    </div>
<?php endif; ?>

This code retrieves the product object, creates a link with the “add to cart” URL, and displays your custom image as the button.

Step 5: Compile Your Theme

After making these changes, compile your theme for the updates to take effect:

bin/magento setup:upgrade

Then clear the cache:

bin/magento cache:flush

Conclusion

Replacing Magento’s default “Add to Cart” button with a custom image is a great way to enhance the visual appeal of your store. Following this tutorial ensures that you accomplish this task efficiently and correctly.

Remember, in order to make these changes permanent across upgrades, it’s recommended to create a child theme based on your current theme and apply these modifications there. You can learn more about creating child themes at Laravel Company’s Magento Child Themes Guide.

This process requires some basic knowledge of PHP and XML, but it’s relatively straightforward once you understand the structure of your theme files. If you need further assistance or have questions about specific customizations, feel free to reach out to our team at Laravel Company.

Checkout Catalog Themes

Our network