Skip to content

Image Compression Component ​

1. Entry ​

Settings -> Components -> Image Compression

On this page you can:

  • Enable or disable image compression
  • Adjust the maximum side length
  • Adjust compression quality
  • Choose output format

2. Scope ​

Image compression processes newly added image attachments before upload.

  • It only applies to image attachments, not regular files or audio attachments
  • It only affects newly added attachments and does not go back to reprocess existing ones
  • It is disabled by default and only affects images added after you turn it on

3. Configurable options ​

  • Enable image compression: master switch.
  • Max side: limits the longest side of the output image. Range: 640 to 4096 px; default: 1920 px.
  • Quality: controls compression quality. Range: 30 to 95; default: 80.
  • Output format: Auto, JPEG, or WebP; default: JPEG.

4. Good use cases ​

  • You often upload screenshots or photos in weak-network environments
  • You want to reduce attachment upload size and sync pressure
  • You want a better balance between detail and file size

5. Backup and restore ​

If you use WebDAV configuration backup / restore, image compression settings are also available as a restorable config item.

6. Common questions ​

Why did my older images not change after I enabled it? ​

That is expected. Image compression only applies to image attachments you add after enabling it. Existing attachments are not reprocessed.

Why do file attachments or audio attachments stay the same? ​

Because image compression only processes image attachments.

Which setting should I tune first? ​

Start with the defaults:

  • If you want smaller uploads, lower Quality first, then reduce Max side if needed
  • If you want to keep more detail, keep the default quality and increase Max side only when necessary