XR Markers
XR Markers enable image-tracking AR — visitors point their device camera at a physical image (a poster, product label, business card, etc.) and your 3D scene anchors to it in real space.
Browser Requirements
XR Marker tracking uses WebXR Incubations APIs currently available in Google Chrome and Microsoft Edge with a flag enabled on the visitor's device.
Enabling WebXR Incubations in Chrome:
- Open a new tab and go to
chrome://flags/#webxr-incubations - Set WebXR Incubations to Enabled
- Click Relaunch to restart Chrome
This step is required on the visitor's device. Scenes that use XR Markers display the Chrome flag setup guide automatically when visitors launch in AR mode.
Adding a Marker
Insert the marker element
Click the XR Marker button in the toolbar. A marker element is placed in the scene and the Marker Panel opens on the right.
Upload a marker image
In the Marker Panel, upload the image you want to track (PNG or JPG). This is the physical image that visitors will point their camera at.
Use a high-contrast image with distinct visual features for the best tracking reliability. Avoid plain colors, repetitive patterns, and very small images.
Enable root anchoring (optional)
Toggle Root Anchor in the Marker Panel to attach the entire scene to the marker's real-world position and orientation — the whole 3D scene appears relative to the physical image when detected.
Enable Stationary (available when Root Anchor is on) to keep the scene fixed at its detected position even after the marker leaves the camera frame.
Fit to image (optional)
Click Fit to image to automatically resize the marker element in 3D space to match the uploaded image's aspect ratio.
Configure interactions (optional)
Use the Interaction system with Marker Found and Marker Lost triggers to animate elements or display popups when the marker is detected or leaves the frame.
Tips
- XR Marker scenes are best experienced on mobile devices in AR mode
- Your scene's published link works across all devices — visitors without AR capability see the standard 3D view
- For reliable detection, a minimum of 8–10 cm per edge is recommended depending on the application and typical viewing distance
- Combine Root Anchor with Effects and state transitions for rich, layered AR storytelling
Image tracking takes the uploaded image aspects as reference. Ensure XR markers in OXR scenes are fit to image.