feat(v6): update cloudflare default image service by Princesseuh · Pull Request #13267 · withastro/docs

Princesseuh · 2026-02-13T13:39:37Z

Description (required)

withastro/astro#15435 changes the default to use the bindings instead of compile because compile's dev behavior is not intuitive anymore (yet)

netlify · 2026-02-13T13:39:42Z

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	`1d0e5b5`
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/699cd1ce6458c3000838d8e8
😎 Deploy Preview	https://deploy-preview-13267--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

astrobot-houston · 2026-02-13T13:40:00Z

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
en/guides/integrations-guide/cloudflare.mdx	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

sarah11918 · 2026-02-16T20:00:08Z

Just noting that this will need an entry in the Cloudflare upgrade guide here too, where the change is clearly noted and with any upgrade guidance! https://v6.docs.astro.build/en/guides/integrations-guide/cloudflare/#upgrading-to-v13-and-astro-6

Normally when a default setting has changed, we say things like "inspect your deployed project for anything funky" in case this affects them. And if possible, we like to give advice on what to do to "revert to the previous behavior" (since presumably that was already working), which in this case seems to be explicitly setting imageService: "compile"

Edited to add: Will note that this won't go in the main v6 upgrade guide since it's just for Cloudflare, but you can see what other "Changed default" entries typically look like there for inspiration! https://v6.docs.astro.build/en/guides/upgrade-to/v6/#changed-defaults

sarah11918 · 2026-02-23T00:25:52Z

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

 - **`cloudflare-binding`:** Uses the [Cloudflare Images binding](https://developers.cloudflare.com/images/transform-images/bindings/) for image transformation. The binding is automatically provisioned when you deploy.
 - **`passthrough`:** Uses the existing [`noop`](/en/guides/images/#configure-no-op-passthrough-service) service.
- **`compile`:** Uses Astro's default service (Sharp), but only on pre-rendered routes at build time. For pages rendered on demand, all `astro:assets` features are disabled.
+- **`compile`:** Transforms images at build time for pre-rendered routes. Uses passthrough for on-demand rendered pages.


This should still say what it uses, like all the other options, since this option is to define which image service is being used.

And, is the previous sentence now incorrect, that all astro:assets features are disabled for pages rendered on demand? That seemed a very clear way of stating it, so if it hasn't changed, I'm wondering why the wording has? Or do you want to emphasize the passthrough runtime behaviour? If so, then I'd write passthrough in code, something like:

Suggested change

- **`compile`:** Transforms images at build time for pre-rendered routes. Uses passthrough for on-demand rendered pages.

- **`compile`:** Uses XXXXXXX to transform images at build time for prerendered routes. The noop `passthrough` option is configured for on-demand rendered pages.

(Also, note that we're standardizing docs around prerendered (no hyphen) as we get around to them, so might as well update that here!)

c7af404

The reason it just says locally instead of explaining exactly what it uses to transform is because its using sharp but through miniflare so its not exactly the same as it was before when we just said it uses sharp

But, it's still using something, right? ~~And, I don't see the above saying "local" anywhere~~ (sorry, can see the text was updated which isn't visible looking at this conversation view!), which certainly could be incorporated for more explanation! If this is about configuring which image service is used, I do think the option should be described in terms of what (service) is or isn't being used, something along the lines of:

"Uses a combination of internal dependencies to transform images locally at build time for prerendered pages"

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>

sarah11918 · 2026-02-23T12:14:19Z

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

 <p>
-**Type:** `'passthrough' | 'cloudflare' | 'cloudflare-binding' | 'compile' | 'custom'`<br />
-**Default:** `'compile'`
+**Type:** `'passthrough' | 'cloudflare' | 'cloudflare-binding' | 'compile' | 'custom' | { build: 'compile', runtime?: 'cloudflare-binding' | 'passthrough' }`<br />


Suggested change

**Type:** `'passthrough' | 'cloudflare' | 'cloudflare-binding' | 'compile' | 'custom' | { build: 'compile', runtime?: 'cloudflare-binding' | 'passthrough' }`<br />

**Type:** `'passthrough' | 'cloudflare' | 'cloudflare-binding' | 'compile' | 'custom' | 'compile-and-run'`<br />

So, I woke up this morning thinking, "If there really is only one reasonable configuration option for this thing, can we just give it a simple name (while using the implementation under the hood)?

This is a dummy name, but wouldn't it make sense to just do that?

The original idea was it opens the door to more in future, and acts as an invitation to anyone who wants to add more like custom to runtime

In that scenario, wouldn't you want the type to be something like ImageService | { build: ImageService, runtime: ImageService } rather than only allowing one?

I'll not resolve this thread in case there's any response to Matt's comment here, but noting for the record that I do not intend for my suggestion here to be taken!

Yes probably the ideal is { build: ImageService, dev: ImageService, runtime: ImageService }

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

sarah11918 · 2026-02-23T20:46:10Z

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

  }),
 });
-```



We're missing closing ``` here!

sarah11918 · 2026-02-23T20:54:27Z

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

 });
-```

 ### `sessionKVBindingName`


OK, the link checker is claiming this section doesn't exist, but clearly it does... it might be confused by the missing/open ``` so I'll try to add them in myself

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

sarah11918

Alright, I think we got there! Thanks for everyone's patience and help!

feat(v6): update cloudflare default

52a7308

Princesseuh mentioned this pull request Feb 13, 2026

fix: update Cloudflare adapter's default image service withastro/astro#15435

Merged

sarah11918 added this to the v6.0.0 docs milestone Feb 16, 2026

sarah11918 added improve or update documentation Enhance / update existing documentation (e.g. add example, improve description, update for changes) merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) 6.0 labels Feb 16, 2026

add upgrade guide entry and update imageService descriptions

db10873

OliverSpeir approved these changes Feb 22, 2026

View reviewed changes

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

OliverSpeir and others added 4 commits February 23, 2026 00:29

Update src/content/docs/en/guides/integrations-guide/cloudflare.mdx

a741a3b

Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>

Update src/content/docs/en/guides/integrations-guide/cloudflare.mdx

dfbb4d8

Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>

Update src/content/docs/en/guides/integrations-guide/cloudflare.mdx

d23a9c3

Co-authored-by: Sarah Rainsberger <5098874+sarah11918@users.noreply.github.com>

Update src/content/docs/en/guides/integrations-guide/cloudflare.mdx

c7af404

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Show resolved Hide resolved

Sarah's suggestions for dealing with the object config

2769e33

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Show resolved Hide resolved

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

sarah11918 and others added 2 commits February 23, 2026 16:03

update 'compile' to follow same format as others

c877248

remove example

d274e8a

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx

}),

});

```

Copy link

Member

sarah11918 Feb 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're missing closing ``` here!

sarah11918 reviewed Feb 23, 2026

View reviewed changes

missing end of code block

d5392ec

yanthomasdev reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Outdated Show resolved Hide resolved

Thank you, Yan.

133487e

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>

sarah11918 reviewed Feb 23, 2026

View reviewed changes

src/content/docs/en/guides/integrations-guide/cloudflare.mdx Show resolved Hide resolved

make new paragraph

1d0e5b5

sarah11918 approved these changes Feb 23, 2026

View reviewed changes

sarah11918 added the Merge Queue Approved and ready to be merged (wait for feature release if also labelled M-O-R)! label Feb 23, 2026

	- `compile`: Transforms images at build time for pre-rendered routes. Uses passthrough for on-demand rendered pages.
	- `compile`: Uses XXXXXXX to transform images at build time for prerendered routes. The noop `passthrough` option is configured for on-demand rendered pages.

	Type: `'passthrough' \| 'cloudflare' \| 'cloudflare-binding' \| 'compile' \| 'custom' \| { build: 'compile', runtime?: 'cloudflare-binding' \| 'passthrough' }`<br />
	Type: `'passthrough' \| 'cloudflare' \| 'cloudflare-binding' \| 'compile' \| 'custom' \| 'compile-and-run'`<br />

Uh oh!

Comments

Conversation

Princesseuh commented Feb 13, 2026

Description (required)

Uh oh!

netlify bot commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

astrobot-houston commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lunaria Status Overview

Tracked Files

Uh oh!

sarah11918 commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sarah11918 Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

OliverSpeir Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

sarah11918 Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sarah11918 Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

OliverSpeir Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

ascorbic Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

sarah11918 Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

OliverSpeir Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sarah11918 Feb 23, 2026

Choose a reason for hiding this comment

Uh oh!

sarah11918 Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

sarah11918 left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

netlify bot commented Feb 13, 2026 •

edited

Loading

astrobot-houston commented Feb 13, 2026 •

edited

Loading

sarah11918 commented Feb 16, 2026 •

edited

Loading

sarah11918 Feb 23, 2026 •

edited

Loading

sarah11918 Feb 23, 2026 •

edited

Loading

sarah11918 Feb 23, 2026 •

edited

Loading