(image_file_formats)=

Image file formats

Using the picture element

Wagtail provides the picture template tag to render a picture element with multiple image formats, letting the browser choose the one it prefers. For example:

{% load wagtailimages_tags %}

{% picture myimage format-{avif,webp,jpeg} width-1000 %}

(customizing_output_formats)=

Customizing output formats

By default, all avif, bmp and webp images are converted to the png format when no image output format is given, and heic images are converted to jpeg.

The default conversion mapping can be changed by setting the WAGTAILIMAGES_FORMAT_CONVERSIONS to a dictionary, which maps the input type to an output type.

For example:

    WAGTAILIMAGES_FORMAT_CONVERSIONS = {
        'avif': 'avif',
        'bmp': 'jpeg',
        'webp': 'webp',
    }

will convert bmp images to jpeg and disable the default avif and webp to png conversion.