Skip to content

Server Upload Limits

High-quality images, especially in a lossless format such as png, can push saved files past the default upload limits of your web server and PHP. Because image file size can increase after editing, raise these limits so the Image Editor can save large images without errors.

Nginx

By default, Nginx does not allow files over 1 MB. To increase the limit to 128 MB in your nginx.conf file:

client_max_body_size 128M;

The equivalent Apache setting is LimitRequestBody, which defaults to 0 (unlimited) upstream. Some distributions, such as RHEL 8.7+ and 9.1+, ship a packaged default of 1 GiB instead, so check your distribution's configuration if you are unsure.

Limit to required routes only

This setting only needs to affect the Image Editor save routes. Consider limiting it to these locations in your Nginx or Apache config:

  • /hyva_image_editor/image/save
  • /hyva_image_editor/image/duplicate

PHP

To increase the limit to 100 MB in your php.ini file:

post_max_size=128M
upload_max_filesize=100M

Set post_max_size higher than upload_max_filesize to leave room for request overhead beyond the file data itself.

Limit to admin scope

Where possible, for example if you use a separate php.ini for admin requests, limit these changes to the admin area only, not the storefront.