How to resize images at upload in Magento (for real)?

How to resize images at upload in Magento (for real)?

August 7, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to resize images at upload in Magento (for real)?

Resizing Images at Upload in Magento: A Comprehensive Guide

As an experienced Magento developer, I understand that image resizing during upload is a critical feature for managing storage space and optimizing website performance. In this guide, we’ll explore how to achieve automatic image resizing using plugins and Magento’s built-in settings.

Understanding the Image Resize Process in Magento

Magento automatically generates multiple versions of an uploaded image based on predefined sizes (e.g., small, medium, large). However, as you’ve pointed out, these versions can consume significant storage space if users upload high-resolution images. To address this issue, we’ll create a custom plugin to enforce size limitations during the upload process.

Identifying the Relevant Class and Method

The key class responsible for image processing in Magento is Mage_Core_Model_File_Validator_Image. This class contains methods that validate and manipulate images before they are saved.

The specific method we need to override is validate within this class. By extending this method, we can add our custom logic for resizing images based on the specified dimensions in Magento’s settings.

Creating a Custom Plugin

To create a plugin that extends the validate method of Mage_Core_Model_File_Validator_Image, follow these steps:

  1. Create an XML configuration file (e.g., app/code/local/YourVendor/YourExtension/etc/config.xml) and add the following content:
<config>
    <modules>
        <YourVendor_YourExtension>
            <version>0.1</version>
        </YourVendor_YourExtension>
    </modules>
    <global>
        <models>
            <yourvendor_yourextension>
                <class>YourVendor_YourExtension_Model</class>
            </yourvendor_yourextension>
        </models>
        <events>
            <core_file_validator_image_before_process>
                <observers>
                    <yourvendor_yourextension_observer>
                        <type>singleton</type>
                        <class>YourVendor_YourExtension_Model_Observer</class>
                        <method>processImageBeforeSave</method>
                    </yourvendor_yourextension_observer>
                </observers>
            </core_file_validator_image_before_process>
        </events>
    </global>
</config>
  1. Create a custom observer class (e.g., app/code/local/YourVendor/YourExtension/Model/Observer.php) and implement the processImageBeforeSave method:
<?php

class YourVendor_YourExtension_Model_Observer
{
    public function processImageBeforeSave($observer)
    {
        $image = $observer->getEvent()->getValidator();
        $maxWidth = 1024;
        $maxHeight = 768;

        // Check if the image needs resizing
        list($currentWidth, $currentHeight) = getimagesize($image->temp_name);

        if ($currentWidth > $maxWidth || $currentHeight > $maxHeight) {
            $newImageResource = $this->resizeImage($image->temp_name, $maxWidth, $maxHeight);

            // Save the resized image to a temporary file
            $tmpFilename = tempnam('/tmp', 'MGD_');

            imagejpeg($newImageResource, $tmpFilename);
            imagedestroy($newImageResource);

            // Replace the original temporary file with the resized one
            rename($tmpFilename, $image->temp_name);
        }
    }

    private function resizeImage($fileName, $maxWidth, $maxHeight)
    {
        list($width, $height) = getimagesize($fileName);

        if ($width > $maxWidth || $height > $maxHeight) {
            $aspectRatio = min(1, $maxWidth / $width, $maxHeight / $height);
            $newWidth = (int) ($width * $aspectRatio);
            $newHeight = (int) ($height * $aspectRatio);

            switch(strtolower(pathinfo($fileName, PATHINFO_EXTENSION))) {
                case 'jpg':
                case 'jpeg':
                    $imageResource = imagecreatefromjpeg($fileName);
                    break;
                case 'png':
                    $imageResource = imagecreatefrompng($fileName);
                    break;
                default:
                    return false;
            }

            $resizedImage = imagescale($imageResource, $newWidth, $newHeight);

            return $resizedImage;
        } else {
            return false;
        }
    }
}

Configuring Image Resize Settings in Magento

To set the maximum width and height for resizing images, navigate to System > Configuration > Catalog > Product Image Size Settings.

Enter your desired dimensions (e.g., 1024x768) in the “Small Image Width” and “Small Image Height” fields respectively.

Conclusion

Automatic image resizing during upload is a crucial feature for managing storage space and optimizing website performance in Magento. By creating a custom plugin that extends the validate method of Mage_Core_Model_File_Validator_Image, we can enforce size limitations based on Magento’s settings.

Remember to clear your cache after implementing this solution, as Magento uses cached images during the upload process.

For more advanced image manipulation and optimization techniques in Magento, consider exploring our guide on optimizing product images for better performance.

Happy coding!

Performance Extensions Configuration Errors

Our network