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