Supported Formats

This page describes the image formats that Manael can accept as input and the output formats it produces.

Conversion table

Input format	Output format	Notes
JPEG	WebP / AVIF (if enabled)
PNG	WebP	AVIF output is intentionally disabled for PNG
APNG	Pass-through (original APNG)	Conversion is skipped to preserve animation data
Animated GIF	Pass-through (original GIF)	Conversion is skipped to preserve animation data
Static GIF	WebP	Added in v2.1.0

Notes

AVIF for JPEG only

AVIF conversion is supported for JPEG source images only. PNG images are intentionally excluded from AVIF conversion to preserve transparency and maintain broad compatibility. PNG images are still converted to WebP when the client supports it.

Pass-through for animated formats

Manael automatically detects animated images — both Animated PNG (APNG) and Animated GIF — and returns them to the client unchanged. This behavior prevents losing animation data that would occur if an animated image were converted to a single static frame in WebP or AVIF. The original file is returned regardless of the Accept header sent by the client.