导航|地址|刷新
Troubleshooting

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/images/llms.txt
Use this file to discover all available pages before exploring further.

Docs Directory API SDKs Changelog

Search

Log in

Cloudflare Images

/

Overview

Get started

Introduction

Key concepts

Limits and formats

Optimization

Features

Remote images (transformations)

Overview

Define source origins

Create transformation flows

Transform via fetch

Control origin access

Draw overlays and watermarks

Integrate with frameworks

Set up rewrite rules

Preserve Content Credentials

Hosted images

Serve uploaded images

Create predefined variants

Enable flexible variants

Apply blur

Delete variants

Preserve Content Credentials

Browser TTL

Serve images from custom domains

Serve private images

Optimize with Workers

Draw overlays and watermarks

Make responsive images

Storage

Upload images

Methods

Upload via URL

Upload via custom path

Accept user-uploaded images

Upload via batch API

Upload via a Worker

Upload via Sourcing Kit

Overview

Enable Sourcing Kit

Edit sources

Credentials

Configure webhooks

Manage hosted images

Edit images

Export images

Delete images

Manage with Workers

Demos and architectures

Pricing

Cloudflare Polish

Overview

Activate Polish

Polish compression

Cf-Polished statuses

WebP may be skipped

Images API Reference ↗API

Reference

Troubleshooting

Security

Tutorials

Optimize mobile viewing

Transform user-uploaded images before uploading to R2

Examples

Platform

Changelog

Agent resources

Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Cloudflare Images llms.txt ↗

Cloudflare Images llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗

Home

/Cloudflare Images

/Reference

/Troubleshooting

Troubleshooting

Last updated Apr 21, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewRequests without resizing enabledError responses from resizingLimitsAuthorization and cookies are not supportedCaching and purging

Requests without resizing enabled

Does the response have a Cf-Resized header? If not, then resizing has not been attempted. Possible causes:

The feature is not enabled in the Cloudflare Dashboard.

There is another Worker running on the same request. Resizing is "forgotten" as soon as one Worker calls another. Do not use Workers scoped to the entire domain /*.

Preview in the Editor in Cloudflare Dashboard does not simulate image resizing. You must deploy the Worker and test from another browser tab instead.

------

Error responses from resizing

When resizing fails, the response body contains an error message explaining the reason, as well as the Cf-Resized header containing err=code:

9401 — The required arguments in {cf:image{…}} options are missing or are invalid. Try again. Refer to Fetch options for supported arguments.

9402 — The image was too large or the connection was interrupted. Refer to Supported formats and limitations for more information.

9403 — A request loop occurred because the image was already resized or the Worker fetched its own URL. Verify your Worker path and image path on the server do not overlap.

9406 & 9419 — The image URL is a non-HTTPS URL or the URL has spaces or unescaped Unicode. Check your URL and try again.

9407 — A lookup error occurred with the origin server's domain name. Check your DNS settings and try again.

9404 — The image does not exist on the origin server or the URL used to resize the image is wrong. Verify the image exists and check the URL.

9408 — The origin server returned an HTTP 4xx status code and may be denying access to the image. Confirm your image settings and try again.

9509 — The origin server returned an HTTP 5xx status code. This is most likely a problem with the origin server-side software, not the resizing.

9412 — The origin server returned a non-image, for example, an HTML page. This usually happens when an invalid URL is specified or server-side software has printed an error or presented a login page.

9413 — The image exceeds the maximum image area of 100 megapixels. Use a smaller image and try again.

9420 — The origin server redirected to an invalid URL. Confirm settings at your origin and try again.

9421 — The origin server redirected too many times. Confirm settings at your origin and try again.

9422 - The transformation request is rejected because the usage limit was reached. If you need to request more than 5,000 unique transformations, upgrade to an Images Paid plan.

9432 — The Images Binding is not available using legacy billing. Your account is using the legacy Image Resizing subscription. To bind Images to your Worker, you will need to update your plan to the Images subscription in the dashboard.

9504, 9505, & 9510 — The origin server could not be contacted because the origin server may be down or overloaded. Try again later.

9523 — The /cdn-cgi/image/ resizing service could not perform resizing. This may happen when an image has invalid format. Use correctly formatted image and try again.

9524 — The /cdn-cgi/image/ resizing service could not perform resizing. This may happen when an image URL is intercepted by a Worker. As an alternative you can resize within the Worker. This can also happen when using a pages.dev URL of a Cloudflare Pages project. In that case, you can use a Custom Domain instead.

9520 — The image format is not supported. Refer to Supported formats and limitations to learn about supported input and output formats.

9522 — The image exceeded the processing limit. This may happen briefly after purging an entire zone or when files with very large dimensions are requested. If the problem persists, contact support.

9529 - The image timed out while processing. This may happen when files with very large dimensions are requested or the server is overloaded.

9424, 9516, 9517, 9518 — Internal errors. Please contact support if you encounter these errors.

------

Limits

These are the limits for images that are stored outside of Images:

Maximum image size is 100 megapixels (for example, 10,000×10,000 pixels large). Maximum file size is 100 megabytes (MB). GIF/WebP animations are limited to 50 megapixels total (sum of sizes of all frames).

Bring Your Own IP (BYOIP) is not compatible with Images when optimizing remote images (transformations).

When Polish can't optimize an image the Response Header Warning: cf-images 299 "original is smaller" is returned.

------

Authorization and cookies are not supported

Image requests to the origin will be anonymized (no cookies, no auth, no custom headers). This is because we have to have one public cache for resized images, and it would be unsafe to share images that are personalized for individual visitors.

However, in cases where customers agree to store such images in public cache, Cloudflare supports resizing images through Workers on authenticated origins.

------

Caching and purging

Changes to image dimensions or other resizing options always take effect immediately — no purging necessary.

Image requests consists of two parts: running Worker code, and image processing. The Worker code is always executed and uncached. Results of image processing are cached for one hour or longer if origin server's Cache-Control header allows. Source image is cached using regular caching rules. Resizing follows redirects internally, so the redirects are cached too.

Because responses from Workers themselves are not cached at the edge, purging of Worker URLs does nothing. Resized image variants are cached together under their source’s URL. When purging, use the (full-size) source image’s URL, rather than URLs of the Worker that requested resizing.

If the origin server sends an Etag HTTP header, the resized images will have an Etag HTTP header that has a format cf-<gibberish>:<etag of the original image>. You can compare the second part with the Etag header of the source image URL to check if the resized image is up to date.

PreviousWebP may be skippedNextSecurity

Was this helpful?

YesNo

Edit pageReport issue

On this page

Overview

Requests without resizing enabled

Error responses from resizing

Limits

Authorization and cookies are not supported

Caching and purging

Edit pageReport issue

Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search

Company
AboutCareersInvestorsPressPress kitGlobal network

Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG

Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse

Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog

Developers
DocumentationLearning centerCommunity

Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform

Start BuildingLog In

© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices

Docs

------
导航页打开网址