Skip to Content
Platform.Ontology

WebXR immersive VR and AR sessions

Starts a full VR or AR session on a headset or phone.

Asks you firstHardware and accessoriesXRWeb browsersWhile you use it

In one line

Can start a full VR or AR session after you allow it

Starts a full VR or AR session on a headset or phone.

Streams head and controller pose every frame and, in AR, shows the camera view of the room. Reveals body movement, height and surroundings.

What it can and can't do

What the user does: You tap Enter VR or View in AR and allow the pop up.

It can

  • Fill your view with a VR scene
  • Show AR items placed in your room
  • Track your head and device movement while the session runs

It cannot

  • Start without you tapping and allowing
  • See your surroundings in VR
  • Keep running after you leave the session
  • Work in Firefox, Safari or on iPhone

How it differs between platforms: Chrome and Edge support it. Safari and Firefox do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported792019-12-10None
EdgeSupported792020-01-15None
FirefoxNot supportedNot availableNot listedFirefox Desktop dropped support; Meta Quest browser has it
SafariNot supportedNot availableNot listedSafari on visionOS supports immersive-vr; not in BCD
Safari on iPhoneNot supportedNot availableNot listedNo WebXR on iPhone or iPad
Chrome on AndroidSupported792019-12-17None
Samsung InternetSupported12.02020-06-19None

How a site asks for it

APInavigator.xr.isSessionSupported(), requestSession('immersive-vr'|'immersive-ar'|'inline', {requiredFeatures, optionalFeatures})
Permission namexr-spatial-tracking
Permissions policyxr-spatial-tracking
Browser compat keysapi.XRSystem
api.XRSession
api.XRFrame
api.XRPose
How access is grantedprompt
What the user seesPermission bubble for VR or AR tracking; AR may add camera consent
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin; prompt per session for AR on Chrome
How to take it backSite settings, end session, headset system menu
Inside an iframeNeeds allow="xr-spatial-tracking"

Typical flow

  1. Check isSessionSupported
  2. Click Enter VR
  3. requestSession() with features
  4. Frame loop via XRSession.requestAnimationFrame

Data you get

What comes back: 6DoF poses per frame
Shape: stream
How often: per display frame (72 to 120 Hz)

FieldTypeUnitRangePrecision
viewerPose.transform.positionobjectmeterslocal space, unboundedcentimetre scale tracking
viewerPose.transform.orientationobjectquaternionunit quaternionNot listed
inputSources[].gripSpace / targetRaySpaceobjectmetersper controllerNot listed
boundsGeometrylistmeterspolygon of playable areabounded-floor feature
views[].projectionMatrixlistNone4x4 floatsNot listed

Technical limits

  • Needs HTTPS and a user gesture to start
  • Immersive sessions pause when page loses focus
  • Safari desktop and iOS have no WebXR; visionOS Safari supports immersive-vr
  • Firefox dropped WebXR support

The story

What it is

A page can start a full VR or AR session on a headset or phone.

For you

You tap Enter VR or View in your room, and the page takes over your headset or your phone's screen. It asks first.

For makers

Makers can reach VR and AR users with just a link, with no app store. It is used for games, shopping, training and tours.

Where you see it

TypeExampleApps
gamesA browser VR game starts in a headset with one click.Mozilla Hubs, Hyperfy
shoppingYou see a sofa in your room through your phone before you buy.IKEA, Wayfair
educationA web museum tour lets students stand inside an old city.None named
travelA hotel site gives you a VR walk through a room.None named
enterpriseA web training session puts workers in a safe virtual factory.None named
securityA bad VR page could cover your view and hide real world dangers.None named

Risks

  • Disorientation
  • Blocks your view

What the platform says

  • W3C: WebXR Device API. The Immersive Web group pitches WebXR as a way to bring virtual and augmented reality to the web.

Good uses and abuse

Legitimate uses

  • VR games
  • Product visualisation
  • Training

Known abuse

  • Body and room scanning
  • Movement as biometrics

Scores

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

History

  • 2019-12, Chrome 79: WebXR Device API ships
  • 2020-02, Chrome 81: Hit test
  • 2021-08, Chrome 90: Depth sensing and light estimation
  • 2024-12, Chrome 131: Hand tracking
  • 2026-09, Safari 27: Texture array projection layers on visionOS Safari

Sources

How well checked: Checked against real behavior.

On this page