Cloudflare changelogs | Cloudflare Images

Cloudflare Images - Images binding is now billed per unique transformation

Wed, 01 Jul 2026 00:00:00 GMT

The Images binding is now billed per unique transformation, matching the model already used for URL-based transformations. Repeat requests for the same combination of source image and parameters within the same calendar month are counted only once.

Previously, every call to the binding counted as a separate transformation regardless of whether the image or parameters were unique. With this change, you can call the binding on hot paths without paying for each individual request.

Calls to .info() are no longer billed.

For more information, refer to Images pricing and the Images binding documentation.

Cloudflare Images - New optimization features in Images

Tue, 16 Jun 2026 00:00:00 GMT

These updates introduce new features for optimizing and manipulating with Images:

New composite option: Control how overlays are blended with the base image.
Percentage widths: Set the dimensions of an overlay as a fraction of the dimensions of the base image.
New fit modes: Use aspect-crop to always preserve the target aspect ratio or scale-up to always enlarge images.
New upscale parameter: Apply AI upscaling to produce sharper, more detailed results when enlarging images.

Cloudflare Images - Manage hosted images with the Images binding

Wed, 10 Jun 2026 00:00:00 GMT

Use the Images binding to upload, list, retrieve, update, and delete images stored in Images directly from your Worker without managing API tokens or making HTTP requests.

The env.IMAGES.hosted namespace supports the following storage and management operations:

.upload(image, options) — Upload a new image to your account.
.list(options) — List images with pagination.
.image(imageId).details() — Get image metadata.
.image(imageId).bytes() — Stream the original image bytes.
.image(imageId).update(options) — Update metadata or access controls.
.image(imageId).delete() — Delete an image.

For example, you can upload an image from a request body and return its metadata:

const image = await env.IMAGES.hosted.upload(request.body, {
	filename: "upload.jpg",
	metadata: { source: "worker" },
});

return Response.json(image);

Or retrieve and serve the original bytes of a hosted image:

const bytes = await env.IMAGES.hosted.image("IMAGE_ID").bytes();
return new Response(bytes);

For more information, refer to the Images binding.

Cloudflare Images - Transformation flows in Images

Wed, 27 May 2026 00:00:00 GMT

Flows are automated rules that pair conditions (such as file extension, URL path, or query parameter) with parameters. Set up a flow to automatically apply image optimization to matching requests on your zone without writing code or changing URLs.

There are two modes for transformation flows:

Provider flows — Migrate from another image optimization service. Your existing URLs continue to work while Cloudflare rewrites provider-specific parameters to their Cloudflare equivalents. Currently, Cloudflare supports provider flows for Fastly Image Optimizer.
Custom flows — Define your own conditions and actions for use cases like automatic format conversion, responsive sizing with width=auto, or directory-based optimization.

To get started, go to Images > Transformations > Automation in the Cloudflare dashboard ↗.

Learn more about transformation flows.

Cloudflare Images - HEIC support in Cloudflare Images

Tue, 08 Jul 2025 00:00:00 GMT

You can use Images to ingest HEIC images and serve them in supported output formats like AVIF, WebP, JPEG, and PNG.

When inputting a HEIC image, dimension and sizing limits may still apply. Refer to our documentation to see limits for uploading to Images or transforming a remote image.

Cloudflare Images - Bind the Images API to your Worker

Mon, 24 Feb 2025 00:00:00 GMT

You can now interact with the Images API directly in your Worker.

This allows more fine-grained control over transformation request flows and cache behavior. For example, you can resize, manipulate, and overlay images without requiring them to be accessible through a URL.

The Images binding can be configured in the Cloudflare dashboard for your Worker or in the Wrangler configuration file in your project's directory:

{
	"images": {
		"binding": "IMAGES", // i.e. available in your Worker on env.IMAGES
	},
}

[images]
binding = "IMAGES"

Within your Worker code, you can interact with this binding by using env.IMAGES.

Here's how you can rotate, resize, and blur an image, then output the image as AVIF:

const info = await env.IMAGES.info(stream);
// stream contains a valid image, and width/height is available on the info object

const response = (
	await env.IMAGES.input(stream)
		.transform({ rotate: 90 })
		.transform({ width: 128 })
		.transform({ blur: 20 })
		.output({ format: "image/avif" })
).response();

return response;

For more information, refer to Images Bindings.