Skip to content

[v6] trailing slash never for endpoints with file extension #12467

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

Merged
florian-lefebvre merged 10 commits into from
Oct 1, 2025
Merged

[v6] trailing slash never for endpoints with file extension #12467

Changes from 3 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
b952ae4
feat!: trailing slash never for endpoints with file extension
florian-lefebvre Sep 30, 2025
f733545
Update src/content/docs/en/guides/upgrade-to/v6.mdx
florian-lefebvre Sep 30, 2025
1a99e27
Update src/content/docs/en/guides/upgrade-to/v6.mdx
florian-lefebvre Sep 30, 2025
8b5893d
Update src/content/docs/en/guides/upgrade-to/v6.mdx
jsparkdev Oct 1, 2025
35446b9
Apply suggestions from code review
florian-lefebvre Oct 1, 2025
22ed4f2
Update src/content/docs/en/guides/upgrade-to/v6.mdx
florian-lefebvre Oct 1, 2025
57a7ac3
Update src/content/docs/en/guides/upgrade-to/v6.mdx
florian-lefebvre Oct 1, 2025
bbb953c
feat
florian-lefebvre Oct 1, 2025
26259ca
Apply suggestions from code review
florian-lefebvre Oct 1, 2025
277a9b7
feat: move
florian-lefebvre Oct 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions src/content/docs/en/guides/upgrade-to/v6.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,8 @@

### Vite 7.0

<SourcePR number="14445" title="feat: update vite"/>

Astro v6.0 upgrades to Vite v7.0 as the development server and production bundler.

#### What should I do?
Expand Down Expand Up @@ -287,6 +289,8 @@

### Changed: `i18n.routing.redirectToDefaultLocale` default value

<SourcePR number="14406" title="feat(astro)!: update i18n.redirectToDefaultLocale default"/>

In Astro v5.0, the `i18n.routing.redirectToDefaultLocale` default value was `true`. When combined with the `i18n.routing.prefixDefaultLocale` default value of `false`, the resulting redirects could cause infinite loops.

In Astro v6.0, `i18n.routing.redirectToDefaultLocale` now defaults to `false`. Additionally, it can now only be used if `i18n.routing.prefixDefaultLocale` is set to `true`.
Expand All @@ -310,6 +314,25 @@

<ReadMore>Learn more about [Internationalization routing](/en/guides/internationalization/#routing).</ReadMore>

### Changed: endpoints with a file extension cannot be accessed with a trailing slash

<SourcePR number="14457" title="feat!: trailing slash never for endpoints with file extension"/>

In Astro v5.0, endpoints with a pathname ending with a file extension (eg. `/src/pages/sitemap.xml.ts`) could be accessed with a trailing slash (`/sitemap.xml/`) or without (`/sitemap.xml`), no matter the value of `build.trailingSlash`.

In Astro v6.0, these endpoints can only be accessed without a trailing slash.

#### What should I do?

Review your links and remove any referencing an endpoint ending with a file extension and a trailing slash:

```html del={1} ins={2} title="src/pages/index.astro"
<a href="/sitemap.xml/">Sitemap</a>
<a href="/sitemap.xml">Sitemap</a>
```

<ReadMore>Learn more about [`build.trailingSlash`](https://docs.astro.build/en/reference/configuration-reference/#trailingslash).</ReadMore>

Check failure on line 334 in src/content/docs/en/guides/upgrade-to/v6.mdx

View workflow job for this annotation

GitHub Actions / Check Links 

Unwanted absolute link in src/content/docs/en/guides/upgrade-to/v6.mdx, line 334: https://docs.astro.build/en/reference/configuration-reference/#trailingslash Suggested fix: /en/reference/configuration-reference/#trailingslash

## Breaking Changes

The following changes are considered breaking changes in Astro v5.0. Breaking changes may or may not provide temporary backwards compatibility. If you were using these features, you may have to update your code as recommended in each entry.
Expand Down
Loading