Skip to content

AR Component

The AR (Augmented Reality) block lets you embed interactive 3D models in a creative. Users can place virtual objects in their physical environment using their device's camera.

The AR block is available in the Builder's Visuals tab — add it from the block toolbar like any other visual block.

Configuration

OptionDescription
iOS modelA .usdz file displayed via Quick Look on iOS devices
Android modelA .glb or .gltf file displayed via Scene Viewer on Android devices
Poster imageA static image shown before the AR experience launches (tap to activate)
PlacementWhere the model appears in the real world — floor or wall
Auto-rotateToggle automatic rotation of the 3D model

Supported file formats

PlatformFormat
iOS.usdz
Android.glb, .gltf

3D model assets can be uploaded via the asset uploader in the Builder. Each platform requires its own model file — provide both an iOS and Android model for full device coverage.

Loading state

While the 3D model is loading, a "Loading AR model..." indicator is displayed over the block. The indicator disappears once the model finishes loading or an error occurs.

Fallback behavior

The poster image is shown as a static element in the following situations:

  • The device is a desktop browser where native AR is not available
  • The <model-viewer> web component could not be initialized
  • An error occurs while loading the 3D model assets