Magento 2: Get Height Width of Image

Magento 2: Get Height Width of Image

July 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2: Get Height Width of Image

Calculating Image Dimensions in Magento 2

In Magento 2, retrieving the height and width of a product image is a common requirement for responsive design or cropping functionality. This can be achieved using built-in functions and classes provided by the framework.

Understanding Magento’s Image Handling

Magento stores images in the pub/media directory and manages them through the Magento\Framework\Image class. This class provides methods for resizing, cropping, and converting images.

For a product image, the dimensions are defined in the media gallery of the product backend. When you upload an image to a product, Magento automatically generates multiple versions (like 240x240 or 135x135) based on the configured image sizes under Stores > Configuration > Catalog > Product Image Sizes.

Retrieving Image Dimensions

To get the height and width of a product image in Magento 2, you can create a helper method that utilizes the Magento\Framework\Image class. Here’s an example:

use Magento\Framework\File\Size;
use Magento\Framework\Filesystem\DirectoryList;
use Magento\Framework\Filesystem;

class ImageHelper
{
    protected $directoryList;
    protected $ioFile;
    protected $imageFactory;
    private $fileSystem;

    public function __construct(
        DirectoryList $directoryList,
        Filesystem $filesystem,
        Size $ioFile,
        \Magento\Framework\Image\AdapterFactory $imageFactory
    ) {
        $this->directoryList = $directoryList;
        $this->ioFile = $ioFile;
        $this->imageFactory = $imageFactory;
        $this->fileSystem = $filesystem;
    }

    public function getImageDimensions($filename)
    {
        $filePath = $this->directoryList->getPath('media') . '/' . $filename;

        $imageAdapter = $this->imageFactory->create();
        $imageAdapter->open($filePath);

        return [
            'width' => $imageAdapter->getWidth(),
            'height' => $imageAdapter->getHeight()
        ];
    }
}

In this helper, the getImageDimensions() method accepts a filename (without the path) and uses the Magento\Framework\Image adapter to open the file. It then retrieves the width and height using the getWidth() and getHeight() methods.

Using the Helper in a Controller or View

To use this helper in your Magento 2 project, you can inject it into a controller or block class:

class MyController extends \Magento\Framework\App\Action\Action
{
    protected $imageHelper;

    public function __construct(
        \Magento\Framework\App\Action\Context $context,
        ImageHelper $imageHelper
    ) {
        parent::__construct($context);
        $this->imageHelper = $imageHelper;
    }

    public function execute()
    {
        $filename = 'my_image.jpg';
        $dimensions = $this->imageHelper->getImageDimensions($filename);

        // Use the dimensions in your logic
    }
}

Conclusion

Magento 2 provides robust image handling capabilities out of the box. By leveraging the Magento\Framework\Image class and creating helper methods like the one above, you can easily retrieve the height and width of product images for various use cases.

Remember to always clear the cache after making changes to your code in Magento’s production mode. You can do this manually or use a plugin like Laravel Company’s Cache Management.

Magento 2 Catalog Admin Configuration

Our network