diff --git a/src/content/docs/en/guides/upgrade-to/v6.mdx b/src/content/docs/en/guides/upgrade-to/v6.mdx
index 1a6d1f892dddd..41552d4979312 100644
--- a/src/content/docs/en/guides/upgrade-to/v6.mdx
+++ b/src/content/docs/en/guides/upgrade-to/v6.mdx
@@ -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: `` component
+
+
+
+In Astro 5.0, the `` component was renamed to `` to clarify the role of the component. The new name makes it more clear that the features you get from Astro's `` routing component are slightly different from the native CSS-based MPA router. However, a deprecated version of the `` component still existed and may have functioned in Astro 5.x.
+
+Astro 6.0 removes the `` component entirely and it can no longer be used in your project. Update to the `` component to continue to use these features.
+
+#### 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';
+
+
+
+ ...
+
+
+
+
+```
+
+Read more about [view transitions and client-side routing in Astro](/en/guides/view-transitions/).
+
## Changed Defaults
Some default behavior has changed in Astro v5.0 and your project code may need updating to account for these changes.