Skip to content

reference for withastro/astro#15153 #13139

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
jcayzac wants to merge 112 commits into from
Closed

reference for withastro/astro#15153 #13139

jcayzac wants to merge 112 commits into from

Conversation

@jcayzac
Copy link
Contributor

@jcayzac jcayzac commented Jan 25, 2026 •
edited by sarah11918
Loading

Description (required)

This is the reference doc for withastro/astro#15153, for v6.

For Astro version: 5.17.0. See astro PR withastro/astro#15153

sarah11918 and others added 30 commits September 15, 2025 22:21
@sarah11918
create v6 upgrade guide page
099c3a0
@sarah11918
add sections
64ea345
@ellielok @sarah11918
Remove ViewTransitions in v6 (withastro#12347)
1a1f081 
Co-authored-by: Sarah Rainsberger <[email protected]>
@sarah11918
updates home page banner to point to v6
3e61972
@florian-lefebvre
[v6] remove emitESMImage() (withastro#12403)
b0aec7b
@florian-lefebvre @sarah11918
[v6] redirectToDefaultLocale default behaviour change (withastro#12353)
49cfc17 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @sarah11918
[v6]: remove Astro.glob() [i18nIgnore] (withastro#12401)
f7e6625 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @ascorbic @sarah11918
[v6] drop node 18 (withastro#12423)
35cc592 
Co-authored-by: Matt Kane <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre
feat: update version
8292fb3
@florian-lefebvre
[v6] update vite to v7 (withastro#12444)
2b258ce
@florian-lefebvre @sarah11918
[v6] deprecate Astro in getStaticPaths (withastro#12435)
369c7ab 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @sarah11918
[v6] integration api cleanup (withastro#12445)
824ae0d 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @sarah11918
[v6] deprecate import.meta.env.ASSETS_PREFIX (withastro#12468)
43e9116 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @ArmandPhilippot @sarah11918
[v6] clean deprecated APIs (withastro#12469)
e840333 
Co-authored-by: Armand Philippot <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @ascorbic
@jsparkdev @sarah11918
[v6] trailing slash never for endpoints with file extension (withastr…
7586143 
…o#12467)

Co-authored-by: Matt Kane <[email protected]>
Co-authored-by: Junseong Park <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre
fix: diff
844769b
@florian-lefebvre
fix: typo
e397c23
@florian-lefebvre @louisescher @sarah11918
[v6] stabilize experimental.preserveScriptOrder option (withastro#12480)
31685a2 
Co-authored-by: Louis Escher <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @sarah11918
[v6] stabilize experimental.staticImportMetaEnv (withastro#12494)
e3e6ab4 
Co-authored-by: Sarah Rainsberger <[email protected]>
@florian-lefebvre @sarah11918
[v6] remove context.rewrite in actions (withastro#12477)
7306a26 
Co-authored-by: Sarah Rainsberger <[email protected]>
@tkskto @jp-knj @yanthomasdev
i18n(ja): update guides/imports.mdx (withastro#12449)
50394ca 
Co-authored-by: knj <[email protected]>
Co-authored-by: Yan <[email protected]>
@tkskto @yanthomasdev @jp-knj
i18n(ja): update tutorial/5-astro-api/1.mdx (withastro#12452)
7962307 
Co-authored-by: Yan <[email protected]>
Co-authored-by: knj <[email protected]>
@florian-lefebvre @delucis
@yanthomasdev @sarah11918
[v6] stabilize experimental.headingIdCompat (withastro#12510)
b7d1636 
Co-authored-by: Chris Swithinbank <[email protected]>
Co-authored-by: Yan <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
@sarah11918 @florian-lefebvre
simplify experimental flags section (withastro#12587)
a409a05 
Co-authored-by: florian-lefebvre <[email protected]>
@sarah11918 @ascorbic
@ArmandPhilippot @yanthomasdev
support for legacy content collections removed (withastro#12376)
ab8cf68 
Co-authored-by: Matt Kane <[email protected]>
Co-authored-by: Armand Philippot <[email protected]>
Co-authored-by: Yan <[email protected]>
@sarah11918
Merge branch 'main' into v6
40e4e34
@sarah11918 @ArmandPhilippot @louisescher
[i18nIgnore] Localized v6 link failures related to Astro.glob() (with…
88ef3c5 
…astro#12616)

Co-authored-by: ArmandPhilippot <[email protected]>
Co-authored-by: louisescher <[email protected]>
@sarah11918
Merge branch 'main' into v6
19a4fbe
@ocavue @florian-lefebvre @ArmandPhilippot
[v6] disallow number in getStaticPaths params (withastro#12608)
5d03bde 
Co-authored-by: Florian Lefebvre <[email protected]>
Co-authored-by: Armand Philippot <[email protected]>
@Princesseuh @sarah11918
@florian-lefebvre @ArmandPhilippot
feat(reference): Update astro:assets reference for new Astro 6.0 beha…
7bee4c3 
…vior (withastro#12639)

Co-authored-by: Sarah Rainsberger <[email protected]>
Co-authored-by: Florian Lefebvre <[email protected]>
Co-authored-by: Armand Philippot <[email protected]>
@netlify
Copy link

netlify bot commented Jan 25, 2026 •
edited
Loading

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit be46282
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/6977bbe61c44200007f58ddb
😎 Deploy Preview https://deploy-preview-13139--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

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
Copy link
Contributor

astrobot-houston commented Jan 25, 2026 •
edited
Loading

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
de/basics/project-structure.mdx Localization changed, will be marked as complete.
de/tutorial/6-islands/4.mdx Localization changed, will be marked as complete.
en/basics/project-structure.mdx Source changed, localizations will be marked as outdated.
en/getting-started.mdx Source changed, localizations will be marked as outdated.
en/guides/actions.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/cloudcannon.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/keystatic.mdx Source changed, localizations will be marked as outdated.
en/guides/configuring-astro.mdx Source changed, localizations will be marked as outdated.
en/guides/content-collections.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/microsoft-azure.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/netlify.mdx Source changed, localizations will be marked as outdated.
en/guides/endpoints.mdx Source changed, localizations will be marked as outdated.
en/guides/environment-variables.mdx Source changed, localizations will be marked as outdated.
en/guides/images.mdx Source changed, localizations will be marked as outdated.
en/guides/imports.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/cloudflare.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/markdoc.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/mdx.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/netlify.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/node.mdx Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/vercel.mdx Source changed, localizations will be marked as outdated.
en/guides/internationalization.mdx Source changed, localizations will be marked as outdated.
en/guides/markdown-content.mdx Source changed, localizations will be marked as outdated.
en/guides/media/cloudinary.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-create-react-app.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gatsby.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nextjs.mdx Source changed, localizations will be marked as outdated.
en/guides/sessions.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v5.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v6.mdx Localization added, will be marked as complete.
en/guides/view-transitions.mdx Source changed, localizations will be marked as outdated.
en/install-and-setup.mdx Source changed, localizations will be marked as outdated.
en/reference/adapter-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/api-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/cli-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/configuration-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/content-loader-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/error-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/astro-glob-no-match.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/astro-glob-used-outside.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/content-collection-invalid-type.mdx Localization added, will be marked as complete.
en/reference/errors/content-collection-missing-loader.mdx Localization added, will be marked as complete.
en/reference/errors/csp-not-enabled.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/file-glob-not-supported.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/file-parser-not-found.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/get-entry-deprecation-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/get-static-paths-invalid-route-param.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-content-entry-data-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-content-entry-frontmatter-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-glob.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/invalid-i18n-middleware-configuration.mdx Localization added, will be marked as complete.
en/reference/errors/legacy-content-config-error.mdx Localization added, will be marked as complete.
en/reference/errors/live-content-config-error.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/prerender-route-conflict.mdx Source changed, localizations will be marked as outdated.
en/reference/errors/unavailable-astro-global.mdx Localization added, will be marked as complete.
en/reference/experimental-flags/csp.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/fail-on-prerender-conflict.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/heading-id-compat.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/live-content-collections.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/preserve-scripts-order.mdx Source removed, will stop being tracked.
en/reference/experimental-flags/static-import-meta-env.mdx Source removed, will stop being tracked.
en/reference/integrations-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/legacy-flags.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-assets.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-content.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-transitions.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-zod.mdx Source changed, localizations will be marked as outdated.
en/reference/session-driver-reference.mdx Localization added, will be marked as complete.
en/tutorial/1-setup/1.mdx Source changed, localizations will be marked as outdated.
en/tutorial/6-islands/4.mdx Source changed, localizations will be marked as outdated.
en/upgrade-astro.mdx Source changed, localizations will be marked as outdated.
es/basics/project-structure.mdx Localization changed, will be marked as complete.
es/guides/images.mdx Localization changed, will be marked as complete.
es/guides/media/cloudinary.mdx Localization changed, will be marked as complete.
es/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
es/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
es/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
es/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
es/reference/legacy-flags.mdx Localization changed, will be marked as complete.
es/tutorial/5-astro-api/1.mdx Localization changed, will be marked as complete.
es/tutorial/6-islands/4.mdx Localization changed, will be marked as complete.
fr/basics/project-structure.mdx Localization changed, will be marked as complete.
fr/guides/configuring-astro.mdx Localization changed, will be marked as complete.
fr/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete.
fr/guides/integrations-guide/node.mdx Localization changed, will be marked as complete.
fr/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete.
fr/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
fr/reference/adapter-reference.mdx Localization changed, will be marked as complete.
fr/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
fr/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/fail-on-prerender-conflict.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/live-content-collections.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
fr/reference/experimental-flags/static-import-meta-env.mdx Localization removed, will be marked as missing.
fr/reference/integrations-reference.mdx Localization changed, will be marked as complete.
fr/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
hi/basics/project-structure.mdx Localization changed, will be marked as complete.
it/tutorial/6-islands/4.mdx Localization changed, will be marked as complete.
ja/basics/project-structure.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/markdoc.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/mdx.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/node.mdx Localization changed, will be marked as complete.
ja/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-create-react-app.mdx Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-gridsome.mdx Localization changed, will be marked as complete.
ko/basics/project-structure.mdx Localization changed, will be marked as complete.
ko/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete.
ko/guides/integrations-guide/node.mdx Localization changed, will be marked as complete.
ko/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete.
ko/guides/upgrade-to/v5.mdx Localization changed, will be marked as complete.
ko/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
ko/reference/adapter-reference.mdx Localization changed, will be marked as complete.
ko/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
ko/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/fail-on-prerender-conflict.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/live-content-collections.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
ko/reference/experimental-flags/static-import-meta-env.mdx Localization removed, will be marked as missing.
ko/reference/integrations-reference.mdx Localization changed, will be marked as complete.
ko/reference/legacy-flags.mdx Localization changed, will be marked as complete.
ko/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
pl/basics/project-structure.mdx Localization changed, will be marked as complete.
pt-br/basics/project-structure.mdx Localization changed, will be marked as complete.
pt-br/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
pt-br/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
pt-br/reference/legacy-flags.mdx Localization changed, will be marked as complete.
pt-br/tutorial/5-astro-api/1.mdx Localization changed, will be marked as complete.
pt-br/tutorial/6-islands/4.mdx Localization changed, will be marked as complete.
ru/basics/project-structure.mdx Localization changed, will be marked as complete.
ru/recipes/i18n.mdx Localization changed, will be marked as complete.
ru/reference/errors/astro-glob-no-match.mdx Localization removed, will be marked as missing.
ru/reference/errors/astro-glob-used-outside.mdx Localization removed, will be marked as missing.
ru/reference/errors/mixed-content-data-collection-error.mdx Localization changed, will be marked as complete.
ru/tutorial/6-islands/4.mdx Localization changed, will be marked as complete.
zh-cn/basics/project-structure.mdx Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/netlify.mdx Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/node.mdx Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/vercel.mdx Localization changed, will be marked as complete.
zh-cn/guides/upgrade-to/v5.mdx Localization changed, will be marked as complete.
zh-cn/guides/view-transitions.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/reference/adapter-reference.mdx Localization changed, will be marked as complete.
zh-cn/reference/errors/live-content-config-error.mdx Localization changed, will be marked as complete.
zh-cn/reference/experimental-flags/csp.mdx Localization removed, will be marked as missing.
zh-cn/reference/experimental-flags/heading-id-compat.mdx Localization removed, will be marked as missing.
zh-cn/reference/experimental-flags/preserve-scripts-order.mdx Localization removed, will be marked as missing.
zh-cn/reference/integrations-reference.mdx Localization changed, will be marked as complete.
zh-cn/reference/legacy-flags.mdx Localization changed, will be marked as complete.
zh-cn/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
zh-tw/basics/project-structure.mdx Localization changed, will be marked as complete.
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 sarah11918 added this to the 5.17.0 milestone Jan 26, 2026
@sarah11918 sarah11918 added add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) minor-release For the next minor release; in the milestone, "merge queue" when approved by Sarah! and removed 6.0 labels Jan 26, 2026
sarah11918
sarah11918 reviewed Jan 26, 2026
View reviewed changes
Copy link
Member

@sarah11918 sarah11918 left a comment

Choose a reason for hiding this comment

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

Looks great, thank you @jcayzac ! I just updated our wording a tiny bit to be more consistent with our docs style and language (and this is for our upcoming minor release, not waiting on the major).

I think I have retained all the same information, just updated the style, so I'll commit these changes directly so that we can get this ready for a release very soon! If you spot something, please do make a comment here and we can fix it up either before or even after the release. It's easy to make quick updates to docs if needed!

@sarah11918 sarah11918 added the Merge Queue Approved and ready to be merged (wait for feature release if also labelled M-O-R)! label Jan 26, 2026
@sarah11918 sarah11918 changed the base branch from v6 to main January 26, 2026 19:08
@github-actions github-actions bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Jan 26, 2026
@sarah11918 sarah11918 removed the Merge Queue Approved and ready to be merged (wait for feature release if also labelled M-O-R)! label Jan 26, 2026
@sarah11918 sarah11918 mentioned this pull request Jan 26, 2026
Merged
@sarah11918
Copy link
Member

sarah11918 commented Jan 26, 2026

Ugh, I did not successfully switch this to the main branch, since this is for v5.17 minor and not v6. Making a new PR to replace this one for simplicity 😅 #13149

@sarah11918
Copy link
Member

sarah11918 commented Jan 26, 2026

Pick this up in #13149

@sarah11918 sarah11918 closed this Jan 26, 2026
@jcayzac
Copy link
Contributor Author

jcayzac commented Jan 27, 2026

this is for our upcoming minor release, not waiting on the major

@sarah11918 Thanks! I keep getting confused between this PR and the SVG rasterization one (targeting v6), why is that? Am I this old already? 🧓🏼

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@sarah11918 sarah11918 sarah11918 left review comments

Assignees

No one assigned

Labels

add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) minor-release For the next minor release; in the milestone, "merge queue" when approved by Sarah!

Projects

None yet

Milestone

5.17.0

Development

Successfully merging this pull request may close these issues.