Adding Magento's small_image and thumbnail Programmatically

Adding Magento's small_image and thumbnail Programmatically

August 7, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding Magento's small_image and thumbnail Programmatically

Programmatically Adding Magento Small Image and Thumbnail

Magento’s built-in functionality allows you to add product images programmatically using the addImageToMediaGallery method. However, by default, this method only adds an image to the media gallery as a “base” image. It does not automatically generate the small_image or thumbnail versions of the image.

Understanding Magento Image Types

Before we dive into how to solve this issue, let’s understand the different image types in Magento:

  1. Base Image: This is the primary image for your product.
  2. Small Image: A thumbnail version of the base image used on category pages and search results.
  3. Thumbnail: An even smaller version of the image used in lists like wishlists or compare pages.

The Default Behavior

When you call $product->addImageToMediaGallery('/tmp/test.png', 'image', false, false), Magento only adds one image to the media gallery with the “base” type selected. If you want to add a small_image and thumbnail separately, you would need to make three separate calls:

$product->addImageToMediaGallery('/tmp/test.png', 'image', false, false);
$product->addImageToMediaGallery('/tmp/test.png', 'small_image', false, false);
$product->addImageToMediaGallery('/tmp/test.png', 'thumbnail', false, false);

This approach works but is cumbersome and inefficient.

Automatically Generating Small Image and Thumbnail

Unfortunately, there is no built-in Magento method that allows you to automatically generate the small_image and thumbnail when adding a base image. However, you can achieve this by utilizing the Mage_Catalog_Model_Product_Image model.

Here’s how you can do it:

// Load the product
$product = Mage::getModel('catalog/product')->load(2514);

// Set the image path
$imagePath = '/tmp/test.png';

// Add the base image
$product->addImageToMediaGallery($imagePath, 'image', false, false);

// Load the product's image model
$imageModel = Mage::getModel('catalog/product_image', $product);

// Generate and save the small image
$smallImage = $imageModel->constrainOnly(210);
$product->addImageToMediaGallery($smallImage, 'small_image', true, false);

// Generate and save the thumbnail
$thumbnail = $imageModel->constrainOnly(50);
$product->addImageToMediaGallery($thumbnail, 'thumbnail', true, false);

In this script:

  1. We first add the base image to the product using the addImageToMediaGallery method.
  2. Then we load the product’s image model.
  3. We use the constrainOnly method of the image model to generate a small version (210px width) for the small_image and an even smaller version (50px width) for the thumbnail.
  4. Finally, we add these generated images to the media gallery as ‘small_image’ and ‘thumbnail’.

Conclusion

While Magento’s core functionality does not provide a direct way to automatically generate the small_image and thumbnail when adding a base image programmatically, you can achieve this by leveraging the Mage_Catalog_Model_Product_Image model.

This approach ensures that your product images are consistently generated in all required sizes whenever you add an image to your Magento store. It’s a more robust solution than manually adding each type of image separately.

Remember to always test your scripts thoroughly before deploying them to a live environment. If you’re looking for more advanced solutions or need help with custom Magento development, feel free to reach out to the experts at Laravel Company.

Catalog Errors

Our network