Skip to content

Remove ViewTransitions in v6 #12347

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
merged 6 commits into from
Sep 19, 2025
Merged

Remove ViewTransitions in v6 #12347

Changes from 4 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
dc3ad58
Remove ViewTransitions in v6
ellielok Sep 19, 2025
077c5e9
Remove duplicated lines
ellielok Sep 19, 2025
1e6f795
Merge branch 'v6' into patch-1
ellielok Sep 19, 2025
9baca0d
Update coping
ellielok Sep 19, 2025
7c3f322
update wording to focus more on deprecation/removal
sarah11918 Sep 19, 2025
47c9c99
fix changeset grammar
sarah11918 Sep 19, 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
27 changes: 27 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 @@ -75,6 +75,33 @@ The following features have now been entirely removed from the code base and can

Projects now containing these removed features will be unable to build, and there will no longer be any supporting documentation prompting you to remove these features.

### Removed: `<ViewTransitions />` component

<SourcePR number="14400" title="Remove deprecated ViewTransitions component"/>

In Astro 5.0, the `<ViewTransitions />` component was renamed to `<ClientRouter />` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `<ClientRouter />` routing component are slightly different from the native CSS-based MPA router. No functionality has changed. This component has only changed its name. Both components are available in Astro 5.x.

Astro 6.0 removes the `<ViewTransitions />` component, you need to use the `<ClientRouter />` component instead.

#### What should I do?

Replace all occurrences of the `ViewTransitions` import and component with `ClientRouter`:

```astro title="src/layouts/MyLayout.astro" del={1,7} ins={2,8}
import { ViewTransitions } from 'astro:transitions';
import { ClientRouter } from 'astro:transitions';

<html>
<head>
...
<ViewTransitions />
<ClientRouter />
</head>
</html>
```

<ReadMore>Read more about [view transitions and client-side routing in Astro](/en/guides/view-transitions/).</ReadMore>

## Changed Defaults

Some default behavior has changed in Astro v5.0 and your project code may need updating to account for these changes.
Expand Down