ImagesBinding does not preserve animation

I'm trying to composite two images using the Cloudflare ImagesBinding, and I've noticed that when the source image is animated (e.g., GIF or animated WebP), the result becomes a static image.

When using the Fetch API, there's an anim property that defaults to true, allowing animations to be preserved. However, it seems that ImagesBinding does not support this property, and I couldn't find any documentation indicating how to retain animations when using this binding.

Is animation currently unsupported in ImagesBinding, or is there a different way to preserve animations during image compositing?

KaribashOP•5/9/25, 4:08 PM

I find ImagesBinding very appealing as it allows image manipulation via ReadableStream without having to publish the images.
It would be great if support for animated images could be added as well.

Deanna•5/13/25, 11:48 PM

In the meantime, you can draw over an animated GIF when using the draw property in a fetch() request

Deanna•5/13/25, 11:48 PM

https://developers.cloudflare.com/images/transform-images/draw-overlays/

Cloudflare Docs

Draw overlays and watermarks

You can draw additional images on top of a resized image, with transparency and blending effects. This enables adding of watermarks, logos, signatures, vignettes, and other effects to resized images.

Deanna•5/13/25, 11:49 PM

Just tested and this works w/o the binding

KaribashOP•5/16/25, 1:44 PM

@Deanna
I know that the draw property can be used with the Fetch API.
When using the Fetch API, the target image needs to be publicly accessible.
With the images binding, you can pass a ReadableStream, so there is no need to make the image public.
As far as I could see, there was no mention in the documentation that the images binding does not support animated images.
Is there a possibility that animated images will be supported by the images binding in the future?
If not, I believe this limitation should be explicitly stated in the documentation.

Deanna•5/16/25, 6:13 PM

Good call — we'll update the documentation to reflect this limitation. We do intend to support this use case soon, but it's not available yet!

ImagesBinding does not preserve animation

Similar Threads

Similar Threads

Similar Threads