Error: Maximum width and height dimension for upload image is 5000

Error: Maximum width and height dimension for upload image is 5000

October 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Error: Maximum width and height dimension for upload image is 5000

Solving Image Upload Errors in Magento: A Comprehensive Guide

As an experienced e-commerce developer, I frequently encounter image upload issues in Magento stores. One of the most common errors is “Maximum width and height dimension for upload image is 5000”. This article will guide you through understanding this error and provide a step-by-step solution.

Understanding the Image Upload Process in Magento

Before diving into the solution, let’s briefly understand how images are handled in Magento:

  1. Upload: Users or administrators upload images to the media/catalog/product folder.
  2. Resizing: By default, Magento resizes product images for display on the frontend using a script named image_resize.php.
  3. Configuration: The maximum dimensions for image resizing are defined in the configuration file located at app/code/core/Mage/Catalog/etc/config.xml.

Reproducing the Error Scenario

You have a fresh Magento installation (version 1.9.3.2) and an active product that requires an image. When you try to upload a standard PNG or JPG image, you encounter the following error:

Maximum width and height dimension for upload image is 5000

The image appears in the physical media/catalog/product folder but remains invisible in the frontend.

Diagnosing the Problem

To understand why this error occurs, let’s examine the default configuration:

  1. Open the file app/code/core/Mage/Catalog/etc/config.xml.
  2. Search for <max_width> and <max_height> within the <resize_images> section.
  3. Notice that both values are set to 5000.

The issue arises when you attempt to upload an image with dimensions exceeding these thresholds (e.g., an image with a width of 6000 pixels). Magento’s image resizing script fails because it cannot process images larger than the defined maximum size, resulting in the error message.

The Elegant Solution: Increasing Image Dimensions

To resolve this issue without modifying core files, follow these steps:

Step 1: Create a Custom XML Configuration File

Create a new file named catalog.xml inside your custom configuration folder (if it doesn’t exist, create one under app/etc). This file will extend the core configuration.

The content of the file should look like this:

<?xml version="1.0"?>
<config>
    <global>
        <catalog>
            <resize_images>
                <max_width>6500</max_width>
                <max_height>6500</max_height>
            </resize_images>
        </catalog>
    </global>
</config>

Step 2: Increase the Image Dimensions

In this example, I’ve increased the maximum width and height to 6500. You can adjust these values based on your specific requirements.

Step 3: Reload Configuration Cache

To apply the changes, flush the configuration cache:

  1. Log in to your Magento admin panel.
  2. Navigate to System > Cache Management.
  3. Select the Configuration cache option.
  4. Click Flush Cache(s).

Verifying the Solution

After completing these steps, attempt to upload a new product image that exceeds the previous maximum dimensions. This time, the image should be successfully resized and displayed on your frontend without encountering any errors.

Remember that increasing the maximum image size will also increase the server’s resource usage during the image resizing process. Ensure you have adequate memory allocated for Magento to handle larger images efficiently.

Conclusion: Optimizing Image Handling in Magento

This article demonstrated how to solve a common Magento 1.x issue related to image uploads. By understanding the underlying cause and applying a custom configuration approach, we successfully resolved the “Maximum width and height dimension for upload image is 5000” error without modifying core files.

For further reading on optimizing Magento performance, I recommend exploring our blog posts at https://laravelcompany.com/blog. We cover a wide range of topics to help you maximize your e-commerce platform’s potential.

Magento 1 Catalog Admin Configuration

Our network