XRCompositionLayer: layout property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The read-only layout property of the XRCompositionLayer interface is the layout type of the layer.

To specify the layout type of a layer, use one of the layer creation methods and their layout option:

Value

A string. Possible values:

default: The layer accommodates all views of the session. It is recommended to use the texture-array texture type for default layouts.
mono: A single XRSubImage is allocated and presented to both eyes.
stereo: The user agent decides how it allocates the XRSubImage (one or two) and the layout (top/bottom or left/right). It is recommended to use the texture-array texture type for stereo layouts.
stereo-left-right: A single XRSubImage is allocated. Left eye gets the left area of the texture, right eye the right. This layout is designed to minimize draw calls for content that is already in stereo (for example stereo videos or images).
stereo-top-bottom: A single XRSubImage is allocated. Left eye gets the top area of the texture, right eye the bottom. This layout is designed to minimize draw calls for content that is already in stereo (for example stereo videos or images).

Examples

Setting and getting a layer's layout

To specify a layer's layout, use a layer creation method (like XRWebGLBinding.createQuadLayer()) and its layout option. To retrieve the type of layer layout, use the layout property:

const layer = xrGlBinding.createQuadLayer({
  pixelWidth: 1024,
  pixelHeight: 768,
  layout: "stereo",
});

layer.layout; // "stereo"

Specifications

Specification
WebXR Layers API Level 1 # dom-xrcompositionlayer-layout

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`layout` Experimental	Chrome – Full support Chrome 147 (Release date: 2026-04-07) footnote Full support	Edge – Full support Edge 147 (Release date: 2026-04-10) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 131 (Release date: 2026-04-29) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 147 (Release date: 2026-04-07) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – No support Opera Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Experimental. Expect behavior to change in the future.