Personalised, known`3xx.astro` page

[ematipico]

• Accepted Date: 2025-05-19
• Reference Issues/Discussions: Personalise redirects with a `3xx.astro` file #844
• Author: @ematipico
• Champion(s): @ematipico and @avevotsira
• Implementation PR:

Summary

Allow to have a known file called 3xx.astro that allows to return a personalised version of a redirect page

Background & Motivation

Since we introduced i18n routing, there have been cases where this new features uses the redirect engine used by Astro.

This showed some shortcomings in features:

• it's not possible to personalise the markup of the page
• it's not possible to change the delay of the redirect, which makes a difference in SSG, where a short delay is marked as a temporary redirect, while a long delay is a permanent redirect
• i18n routing users can't translate the page

Goals

• similar to 404.astro, to have a 3xx.astro file that will serve any 3 hundred status code
• users can use any markup inside the page
• fallback to the built-in redirect layout if nothing is provided

[florian-lefebvre]

I think a potential issue is that this change may be breaking. Eg. what if a user already has a page named this? Or want to use it not for redirects? It's not the same with 404.astro

[ematipico]

I think a potential issue is that this change may be breaking. Eg. what if a user already has a page named this? Or want to use it not for redirects? It's not the same with 404.astro

It was the same for middleware.js and actions.js, and we haven't shipped them with a major release.

[florian-lefebvre]

I think it's a bit different here because it ends up in the url eg /3xx. Not saying that requires a major, but there's possibility of conflict. it's perfectly valid for a user to want to call a route /3xx without configuring the redirect page IMO

[ematipico]

Yes, and while the feature is under experimental, it's not a problem. If you're really concerned about having many bug reports, we can enable this feature via configuration. I am not concerned.

[ascorbic]

Not really the same, because middleware.js and actions.js aren't in /pages/

[ascorbic]

But I agree – I don't think this requires a major

[Eveeifyeve]

I feel like it should be named redirects or at least use the statuscode because there is two type of redirects a permanent and temporary redirects. there is actually more types of redirects. Or at least provide an api for status codes so users can even customize the messages based on statuscodes.