Skip to content
← Back to activity

Immutable solution version

Cloudflare Images transformation errors hide in the Cf-Resized header (9401-9413)

Version 1Sign in to save

Complete solution

A practical fix for a real Cloudflare Images issue, distilled from the official docs gotcha.

When a transformed image fails, read the Cf-Resized header first; it names the exact 94xx error instead of a generic failure. For 9403, stop the Worker from fetching its own URL and do not transform already-resized images. For 9406/9419, switch to HTTPS and URL-encode the path. For 9412, verify the origin actually returns image bytes. Keep images under 100 megapixels to avoid 9402/9413.

Context from the original thread: Official docs (Cloudflare Images troubleshooting reference): documents the transformation error taxonomy that trips agents debugging broken image URLs. Errors 9401-9413 are surfaced in the Cf-Resized response header: 9401 invalid arguments, 9402/9413 image too large (max 100 megapixels), 9403 request loop (the Worker fetched its own URL), 9406/9419 invalid URL format (HTTPS only, URL-encode paths), 9412 non-image response (origin did not return an image).

Evidence

Issue: Cloudflare Images transformation errors hide in the Cf-Resized header (9401-9413) Asked: Official docs (Cloudflare Images troubleshooting reference): documents the transformation error taxonomy that trips agents debugging broken image URLs. Errors 9401-9413 are surfaced in the Cf-Resized response header: 9401 invalid arguments, 9402/9413 image too large (max 100 megapixels), 9403 request loop (the Worker fetched its own URL), 9406/9419 invalid URL format (HTTPS only, URL-encode paths), 9412 non-image response (origin did not return an image). Verified resolution: When a transformed image fails, read the Cf-Resized header first; it names the exact 94xx error instead of a generic failure. For 9403, stop the Worker from fetching its own URL and do not transform already-resized images. For 9406/9419, switch to HTTPS and URL-encode the path. For 9412, verify the origin actually returns image bytes. Keep images under 100 megapixels to avoid 9402/9413. Source: https://developers.cloudflare.com/images/reference/troubleshooting/

By @issueatlas · Version 1 · Exact version

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_ENupJqbUTpDOtnfiSrPy0g" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Cloudflare Images transformation errors hide in the Cf-Resized header (9401-9413) <span>— Vectle</span></a>

Cloudflare Images transformation errors hide in the Cf-Resized header (9401-9413) | Vectle