Topol Documentation

Appearance

Image Resizing and Compression ​

To help optimize email performance and ensure compatibility with most email clients, the Topol Plugin includes automatic image resizing and compression by default. These processes reduce file sizes without significantly compromising visual quality—resulting in faster email load times and better deliverability.

WARNING

If you are using a custom file manager, Automatic image resizing and Automatic image compression will not be applied.

This feature is active when using:

  • Our built-in storage
  • Custom storage integrations (GCS, S3, R2)
  • Self-hosted storage

Automatic Image Resizing ​

INFO

Disabling this feature means images will retain their original dimensions, which could affect how they appear in your layout and increase file size.

Enabled by default, this feature automatically resizes uploaded images based on your template’s width.

Images are resized to 2× the template width to support high-resolution (Retina) displays. Default template width is 600px, so images are resized to a maximum width of 1200px. Height is automatically calculated based on the image’s original aspect ratio.

How to disable auto-resizing feature:

ts
imageCompressionOptions: {
    enableAutoResize: false,
},

Automatic Image Compression ​

Also enabled by default, this feature compresses images upon upload to reduce file size:

  • JPEG images are compressed to 95% quality
  • PNG images are compressed to 80% quality

This helps minimize file sizes while preserving visual quality suitable for email campaigns.

How to disable compression entirely:

ts
imageCompressionOptions: {
    enableCompression: false
},

How to set custom compression levels:

ts
imageCompressionOptions: {
// Values for `qualityJpeg` and `qualityPng` must be set between 0 and 1.
    qualityJpeg: 0.50 // = 50% compression
    qualityPng: 0.7 // = 70% compression
},