Latest Guide on How to Add Images To Product in Magento 2

In this tutorial, I will show you how to programmatically add images to the product in Magento 2.

Product images play an essential role in building an eye-catching whole product page, which attracts customers in the first place. As a highly flexible and customizable platform, Magento allows adding or removing images from products in different ways. You can save a lot of time without having to add images manually.

Why you should add images to products in Magento 2?

You should not skip this tutorial especially if you haven’t present your products with stunning images. The benefits you can see after getting this done are numerous. It helps beautify your products, improve SEO performance, enhance customer experience, and more.

Now let’s dig in to how to add/ remove images to product programmatically in Magento 2 with two methods:

In this article, I will show you two method to add/ remove images to product programmatically:

Method 1: Add Or Remove Media Images Programmatically By Using The Magento_Catalog Module Classes

Firstly, I will describe the process of adding and removing images programmatically in Magento 2 by using Magento_Catalog module.

A one-off script is required to run it. Hence, the code displayed will reside in a single file which externally bootstraps the Magento 2 application.

The code below has been tested as of Magento Open Source version 2.2.5 and will delete all existing gallery images from a product, then add a single image, assigning the image to the base, small_image and thumbnail.

The code comments need to meet a few below requirements:

  • The document root of the Magento 2 application must be set to ROOT/pub.
  • The directory containing the images need to be placed within ROOT/pub/media.
  • The images are named identical to the SKU of the product which images should be updated.
  • Make sure that [image_dir] is replaced by the name of the directory which contains the images.

Add a file within the ROOT/pub directory containing the code below and run the code either within the browser or via CLI. You can change various aspects of the file (such as the glob’d image file types) to meet your needs.

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
 * Assumes doc root is set to ROOT/pub
require_once dirname(__DIR__) . '/app/bootstrap.php';
$bootstrap = \Magento\Framework\App\Bootstrap::create(BP, $_SERVER);
class AssignImages extends \Magento\Framework\App\Http implements \Magento\Framework\AppInterface
    public function launch()
        $state = $this->_objectManager->get('Magento\Framework\App\State');
        $galleryReadHandler = $this->_objectManager->create('Magento\Catalog\Model\Product\Gallery\ReadHandler');
        $imageProcessor = $this->_objectManager->create('Magento\Catalog\Model\Product\Gallery\Processor');
        $productGallery = $this->_objectManager->create('Magento\Catalog\Model\ResourceModel\Product\Gallery');
         * Assumed images are named [sku].[ext] and reside in ROOT/pub/media/[image_dir]
        foreach (glob(__DIR__ . "/media/[image_dir]/*.{jpg,png,gif}", GLOB_BRACE) as $image) {
            $imageFileName = trim(pathinfo($image)['filename']);
            $sku = $imageFileName;
            try {
                $product = $this->_objectManager->create('Magento\Catalog\Model\Product')->loadByAttribute('sku', $sku);
                if ($product) {
                    // Unset existing images
                    $images = $product->getMediaGalleryImages();
                    foreach($images as $child) {
                        $imageProcessor->removeImage($product, $child->getFile());
                     * Add image. Image directory must be in ROOT/pub/media for addImageToMediaGallery() method to work
                    $product->addImageToMediaGallery('[image_dir]' . DIRECTORY_SEPARATOR . pathinfo($image)['basename'], array('image', 'small_image', 'thumbnail'), false, false);
                    echo "Added media image for {$sku}" . "\n";
            } catch (\Exception $e) {
                echo $e->getMessage();
        return $this->_response;
    public function catchException(\Magento\Framework\App\Bootstrap $bootstrap, \Exception $exception)
        echo $exception->getMessage();
        return false;
/** @var \Magento\Framework\App\Http $app */
$app = $bootstrap->createApplication('AssignImages');

Method 2: Add Or Remove Media Images Programmatically By Using Object Manager

Now, I will show you the second method to add or remove image from a product by using object manager

// Instance of object manager
$objectManager = \Magento\Framework\App\ObjectManager::getInstance(); 
//Remove Images From Product
$productId =  1 ; // Id of product
$product = $objectManager->create('Magento\Catalog\Model\Product')->load($productId);
$productRepository = $objectManager->create('Magento\Catalog\Api\ProductRepositoryInterface');
$existingMediaGalleryEntries = $product->getMediaGalleryEntries();
foreach ($existingMediaGalleryEntries as $key => $entry) {
/*Add Images To The Product*/
$imagePath = "sample.png"; // path of the image
$product->addImageToMediaGallery($imagePath, array('image', 'small_image', 'thumbnail'), false, false);

Magento 2 extensions

Magento 2 extensions

Allow you to achieve more with your online store

Check it out!


Above are the detailed instructions for adding images to product programmatically in Magento 2. I hope that this guide is helpful for you. If you have any questions or want to show your opinion, feel free to leave a comment below. Thanks for reading!

Image Description
With over a decade of experience crafting innovative tech solutions for ecommerce businesses built on Magento, Jacker is the mastermind behind our secure and well-functioned extensions. With his expertise in building user-friendly interfaces and robust back-end systems, Mageplaza was able to deliver exceptional Magento solutions and services for over 122K+ customers around the world.