Skip to main content

Page last updated 07 October 2026

Images can be uploaded to Contensis in various formats, however the Image API only supports delivery of a subset of image types.

The Image API supports the delivery of the following formats.

FormatExtensionsTransformationsNotes
JPEG.jpg, .jpeg, .jfifYes
PNG.pngYesTransparency is kept.
GIF.gifYes
Animated GIF.gifNoDelivered unchanged, whatever parameters are given, so the animation is kept.
WebP.webpYesAn animated WebP is transformed as its first frame.
TIFF.tif, .tiffYesDelivered as WebP, as most browsers cannot display TIFF. Request format=tiff to keep it. A multi-page TIFF is transformed as its first page.
BMP.bmpYesDelivered as PNG.
SVG.svgNoDelivered unchanged. An SVG is a vector image and scales without the Image API.

Size limits

Two limits apply to the source image when it is transformed:

  • File size, 50MB.
  • Frame size, 50 megapixels. This is the width multiplied by the height, so a 60 megapixel photograph is above the limit however small its file is.

An image beyond either limit is not transformed. Neither limit applies to the original: requesting an image without any transformation parameters returns the file that was uploaded, whatever its size.

Upload images at a size suited to the web and use the Image API to produce smaller versions of them, rather than uploading camera originals and relying on transformations.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.
New support request