Cross-Document View Transitions: The Gotchas Nobody Mentions

This article explains cross-document view transitions, a browser feature enabling smooth page transitions on multi-page sites without frameworks.

• •The deprecated <meta> tag syntax has been replaced with the @view-transition CSS at-rule as the current opt-in method
• •Both source and destination pages must opt-in for transitions to activate; the browser automatically snapshots and animates between pages
• •Transitions have a hard 4-second timeout that silently cancels if the new page doesn't render within that window, causing frustrating debugging on slow connections
• •Conditional opt-in via media queries is supported, including @media (prefers-reduced-motion) for accessibility and viewport-specific activation
• •Currently supported in Chromium-based browsers and Safari 18.2+, with Firefox support in progress as of 2026