Cannot add image through Magento Cms wysiwyg editor

Cannot add image through Magento Cms wysiwyg editor

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Cannot add image through Magento Cms wysiwyg editor

Solving Image Upload Issues in Magento CMS Wysiwyg Editor

As a senior developer working extensively with e-commerce platforms, I frequently encounter issues related to image uploads and the Wysiwyg editor in Magento. The error message you’re experiencing suggests that there might be a problem with the image format being uploaded.

Understanding the Error Message

The error message “Unsupported image format.” indicates that the image file type or its format is not recognized by the system. The Mage_Adminhtml_Cms_WysiwygController.php controller is attempting to open the image using the Gd2 adapter, but it’s failing because the format is unsupported.

Checking Supported Image Formats

Magento supports a range of image formats for use in the CMS Wysiwyg editor, including:

  • JPEG
  • PNG
  • GIF (with transparency)
  • BMP (limited support)

If you’re encountering this error, double-check that your image file has one of these extensions. Also, ensure that there are no leading or trailing spaces in the filename.

Ensuring Image Quality and Size

Magento requires images to be optimized for web use. If an image is too large or hasn’t been adequately compressed, it may cause the Wysiwyg editor to time out during upload, resulting in a slow response.

To optimize your images:

  1. Use a tool like Adobe Photoshop or Gimp to resize and compress the image.
  2. Aim for a reasonable file size - ideally under 500KB for web use.
  3. Ensure the dimensions are appropriate for your page layout.

Checking Server Settings

The error might also be due to server-side limitations:

PHP Configuration

Ensure that the following PHP configurations are set appropriately in your php.ini file (or .htaccess if not possible):

  • file_uploads = On
  • upload_max_filesize = 2M (You may need to increase this depending on your requirements)

File Permissions

The image upload directory (usually var/uploads) must have the correct permissions. The ownership should match with the web server user, and the permissions should be set to something like 755 or 775.

Testing the Image

Before uploading an image through the Wysiwyg editor, try manually uploading it via FTP or SSH to the var/uploads directory of your Magento installation. If the image appears correctly in the media browser afterwards, the issue is likely with how you’re interacting with the Wysiwyg editor itself.

Conclusions and Next Steps

Remember that the Wysiwyg editor is a client-side interface, so any issues with the appearance or upload process can often be resolved by clearing your browser cache, updating to the latest Magento version, or checking for conflicting extensions.

If none of these solutions work, it may be worth reaching out to a professional Magento development agency like Laravel Company for further assistance. Our team of experts specializes in solving complex issues related to e-commerce platforms and can provide advanced troubleshooting services tailored to your specific needs.

In the meantime, continue testing with different image files, formats, and tools to isolate the root cause of the problem. Happy coding!

Performance Extensions Admin Errors

Our network