Image Compressor

Image Compressor resizes images in the browser before they are uploaded, so the server receives a file that already fits the field's maximum dimensions. It uses the Compressor.js library.

It is meant for hosts where server-side resizing is unreliable. On some platforms, large originals exceed memory or upload limits, or GD or ImageMagick fails to scale them, often without an error. Resizing on the client avoids those failures and reduces upload time and bandwidth.

How it works

• The module watches image field widgets that have a Maximum image dimensions setting.
• When a user chooses a file, the browser scales it down to fit within that width and height, keeping the aspect ratio, and re-encodes it at Compressor.js's default quality (0.8).
• The resized file then replaces the original in the file input, and Drupal's normal AJAX upload runs. Server-side validation still applies.
• Images already within the limits are left alone. If re-encoding would produce a larger file, the original is kept.
• Multiple-file uploads are supported. All files are processed before the upload starts.

Requirements

• Drupal 10.1 or later, or Drupal 11.
• Core Image module.
• Compressor.js is bundled with the module. No separate library download is needed.

Installation and use

1. Install the module as usual: composer require drupal/image_compressor, then drush en image_compressor.
2. On each image field that should be resized, set Maximum image dimensions in the field settings, for example 2400 × 2400.
3. No other configuration is needed. Widgets without a maximum are not affected.