How to remove product images in Magento 2

How to remove product images in Magento 2

July 19, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to remove product images in Magento 2

Removing Product Images in Magento 2

If you’re looking to remove product images in Magento 2, you’ve likely found that most guides are still focused on the older Magento 1 architecture. While some concepts remain consistent between the two versions, the removal process for product images is significantly different in Magento 2.

Understanding the New Approach

In Magento 2, the file system and media management have been updated to provide better performance and security. This means you can no longer directly access and remove files using the catalog/product_attribute_media_api model as you would in Magento 1.

Instead, Magento 2 uses a more streamlined approach that involves the product gallery and media storage API. Let’s walk through the steps required to remove images from products in this latest version:

Step-by-Step: Removing Product Images

To remove a single product image or an entire gallery, you’ll need to interact with the productRepository interface provided by Magento 2. Here’s a simplified example of how you can achieve this removal:

<?php
$productId = 1; // Replace with your desired product ID
$productRepositoryInterface = $objectManager->get('\Magento\Catalog\Api\ProductRepositoryInterface');
$product = $productRepositoryInterface->getById($productId);

if ($product) {
    $galleryImages = $product->getMediaGalleryEntries();
    foreach ($galleryImages as $imageKey => $image) {
        // Remove the image from gallery
        unset($product->getMediaGalleryEntries()[$imageKey]);

        // Reindex if necessary to ensure updated data in the database
        $this->_catalogProductImageRepository->save($product);
    }
}

When to Use the Media Storage API

If you’re working with multiple images or a large number of products, it’s recommended to use Magento 2’s media storage API. This provides more control and allows you to delete files directly from the media storage service.

To access this API, you can inject Magento\MediaStorage\Api\FileStorageInterface in your code:

$objectManager->get('Magento\MediaStorage\Api\FileStorageInterface')->delete('/path/to/your/image.jpg');

Remember to replace '/path/to/your/image.jpg' with the actual path of the image you want to delete.

Conclusion: Upgrading Your Approach

As you can see, removing product images in Magento 2 requires a different approach than in Magento 1. The key is understanding and leveraging the new productRepository interface for basic removal tasks or the media storage API for more complex operations.

If you’re looking to learn more about Magento 2’s advanced features and best practices, I highly recommend checking out our comprehensive guide on Magento 2 Development. It offers a deep dive into the architecture changes and provides practical advice for working with this powerful e-commerce platform.

Magento 2 Magento 1 Catalog Performance

Our network