Skip to Content
Platform Ontology

View Transitions

Animates between page states, including across same-origin navigations.

While you use it

A site can capture a screenshot of the old and new state and morph between them. Cross-document transitions work only within one origin, so it cannot reveal another site's pixels.

What it can and can't do

What the user does: Nothing. It happens when you tap a link or the page updates.

It can

  • Fade or slide between two screens
  • Animate a picture moving from a list to a detail page
  • Keep a smooth look when you move between pages on the same site

It cannot

  • Animate between two different sites
  • See what is on the other page before it loads

Browser support

Version notes
  • Safari on iPhone: All iOS browsers use WebKit

How a site asks for it

APIdocument.startViewTransition(); @view-transition { navigation: auto }
Browser compat keysapi.Document.startViewTransition
css.at-rules.view-transition
How access is grantednone
What the user seesNone (no browser prompt)
Needs a secure context (HTTPS)No
Needs a user gestureNo
Activationnone
How long it lastsWhile animating
How to take it backNothing to revoke (no permission is stored)
Inside an iframeSame-origin cross-document only

Typical flow

  1. Call startViewTransition(update)
  2. Browser snapshots old state
  3. Animates to new state

Data you get

Shape: none

No individual data fields. The signal is the access itself.

Technical limits

  • Cross-document transitions are same-origin only (Chrome 126, Safari 18.2)
  • Callback timeout about 4 s before the transition is skipped (Chrome)
  • Does not read or leak cross-origin pixels; snapshots exclude cross-origin iframes content
  • Support: same-document Chrome 111, Safari 18, Firefox 144

The story

What it is

A page can animate smoothly from one screen to the next.

For you

Moving between pages feels like moving inside a phone app: a picture grows into a detail view and nothing flashes white.

For makers

Makers get app like polish with a few lines of code, which helps keep people engaged and makes a site feel premium.

Where you see it

TypeExampleApps
shoppingA product photo grows from a grid thumbnail into the detail page.Airbnb, Shopify stores
mediaA movie poster expands into the title page.None named
gamesA browser game cross fades between menus and levels.None named
newsA story card slides open into the full article.None named
creativeA portfolio site glides between project pages.None named
productivityA web dashboard animates panels as you switch tabs.None named

Risks

  • Motion sickness
  • Slow page switches

What the platform says

Good uses and abuse

Legitimate uses

  • App-like navigation
  • Shared element animations

Known abuse

  • Hiding loading states
  • Jarring animation to disorient

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2023-03, Chrome 111: Same-document view transitions
  • 2024-06, Chrome 126: Cross-document view transitions
  • 2024-09, Safari 18: Same-document view transitions

Sources

How well checked: Based on official documentation.

On this page