Skip to content

Releases: KhronosGroup/OpenXR-Docs

OpenXR Specification (Source) 1.1.63

Choose a tag to compare

@rpavlik rpavlik released this 02 Sep 21:22
release-1.1.63

OpenXR Specification 1.1.63 (2026-09-01)

This release adds two substantial ratified multi-vendor extensions,
XR_EXT_spatial_container and XR_EXT_spatial_container_self_rendering, which
together expand the scope of experiences possible with OpenXR. It also includes
another ratified multi-vendor extension for spatial entity image tracking, as
well as a small ratified Khronos extension to improve a developer convenience
function. Several more single vendor extensions are also included, as well as a
number of cleanups and improvements to the specification.

  • Specification
    • New ratified multi-vendor extension specifications: XR_EXT_spatial_container,
      XR_EXT_spatial_container_self_rendering to allow apps to switch between
      immersive (full-screen) or bounded, allow multiple simultaneous apps, and
      enable the system to control the position of each of the "containers" the apps
      are in.
      (internal MR 3712,
      internal MR 4473)
    • New ratified Khronos extension specification:
      XR_KHR_extended_result_name_lengths adds a new variant of the
      xrResultToString() function which supports XrResult name lengths of up to
      256 characters.
      (internal MR 3964)
    • New ratified multi-vendor extension specification: XR_EXT_spatial_image_tracking
      provides tracking of images in the spatial entities framework.
      (internal MR 3805,
      internal MR 4473)
    • New vendor extension specification: XR_BD_spatial_light_estimation provides
      access to estimated environmental lighting through vendor spatial sensing
      framework.
      (internal MR 3814)
    • New vendor extension specification: XR_BD_camera_image provides access to
      device camera images.
      (internal MR 4089,
      internal MR 4473)
    • New vendor extension specification: XR_SONY_hdr_metadata allowing
      applications to set HDR static metadata for a swapchain.
      (internal MR 4172)
    • Fix: Resolve incorrect implicit valid usage extension requirements generated
      for types/commands that are referenced by a lower-numbered extension before the
      extension that actually introduces them is processed.
      (internal MR 4394,
      internal issue 2054)
    • Fix: Explicitly list the "x" and "y" thumbstick components on
      "pico_g3_controller" in the spec text.
      (internal MR 4437)
    • Fix: Explicitly list the "thumbstick" component on "pico_neo3_controller" and
      "pico4_controller" in the spec text.
      (internal MR 4437)
    • Fix: Typo in XR_META_recommended_layer_resolution.
      (internal MR 4461,
      internal issue 2424,
      OpenXR-Docs issue 179)
    • Improvement: Add a check to xml_consistency.py that ensures all defined types
      are either explicitly or implicitly included.
      (internal MR 2879)
    • Improvement: Clean up and optimize SVG files embedded in the spec.
      (internal MR 4446)
    • Improvement: More consistency changes in example code.
      (internal MR 4473)
  • Registry

OpenXR Specification (Source) 1.1.62

Choose a tag to compare

@rpavlik rpavlik released this 01 Aug 01:32
release-1.1.62

OpenXR Specification 1.1.62 (2026-07-31)

This release includes a new vendor extension, an important fix to several vendor
extension added in the previous release, as well as a number of usability
improvements for the specification itself. For extension authors, there are
workflow improvements: extensions may now be developed in their own "fragment"
XML file and referenced from xr.fragmented.xml. Provided tooling processes
this file to generate the all-inclusive xr.xml previously edited directly.
This reduces the merge conflicts seen during extension development and makes
review easier, without requiring changes to tools expecting the conventional
combined XML file.

  • Specification
    • Fix: Correct XR_KHR_locate_spaces specification sample code that initialized
      XrSpaceLocationsKHR with the wrong structure type,
      XR_TYPE_SPACES_LOCATE_INFO_KHR instead of XR_TYPE_SPACE_LOCATIONS_KHR.
      (OpenXR-Docs PR 200)
    • Improvement: Improve consistency of struct initialization patterns in adoc
      sample code, using designated initializers for clarity.
      (internal MR 4245,
      internal MR 4241,
      internal MR 4242,
      internal MR 4244,
      internal MR 4408)
    • Improvement: Enable warning in docgenerator.py for types that are not
      (explicitly) included in xr.xml.
      (internal MR 4413,
      internal MR 4413)
    • Improvement: Emit "Provided by" doc comment in spec for bit flag values which
      modify existing bit flags.
      (internal MR 4413,
      internal MR 4413)
    • New vendor extension specification: XR_SONY_swapchain_color_space allowing
      applications to specify the color space of swapchain images and to enumerate
      the color spaces supported by the session.
      (internal MR 4171)
  • Registry
    • Change: XML registry xr.xml is now checked in after being constructed from
      xr.fragmented.xml and multiple per-extension XML file fragments, for reduced
      conflicts during development. The schema of xr.xml has not changed. Be sure
      to run specification/scripts/merge-registry.sh after editing
      xr.fragmented.xml or one of the fragments, as most tooling still uses the
      merged XML registry.
      (internal MR 4161)
    • Chore: Register DXR author ID for The DisplayXR Project.
      (OpenXR-Docs PR 201)
    • Fix: Resolve inconsistency between extension numbers for META vendor extensions
      (XR_META_hand_tracking_wide_motion_mode2,
      XR_META_hand_tracking_frequency_hint,
      XR_META_hand_tracking_unextrapolated_poses).
      (internal MR 4380)
    • Fix: Add XR_ERROR_LIMIT_REACHED as an valid return for
      xrAcquireEnvironmentDepthImageMETA matching API description.
      (internal MR 4414)
    • Improvement: Move XR_ANDROID_trackables to extension fragment XML file.
      (internal MR 4161)
    • Improvement: Add explicit type includes for types that are implicitly included
      to improve generated documentation.
      (internal MR 4406,
      internal MR 4413)
    • New vendor extension: XR_SONY_swapchain_color_space
      (internal MR 4171)

OpenXR Specification (Source) 1.1.61

Choose a tag to compare

@rpavlik rpavlik released this 06 Jul 15:52
release-1.1.61

OpenXR Specification 1.1.61 (2026-07-02)

This release primarily features a number of new vendor extensions, plus one
vendor extension fix, clarifications for spatial entities, and additional sample
code cleanup. A small addition to the reflection headers is also included.

  • Specification
    • Fix: Typos in enum value names for XrTrackingOptimizationSettingsHintQCOM.
      (internal MR 4186)
    • Fix: Miscellaneous non-normative fixes to the XR_EXT_spatial_entity spec
      language.
      (internal MR 4355)
    • Improvement: Improve consistency of struct initialization patterns in adoc
      sample code, using designated initializers for clarity in additional sample
      code not converted in the last release.
      (internal MR 4248,
      internal MR 4247,
      internal MR 4246,
      internal MR 4374)
    • New vendor extension specification: XR_ANDROID_spatial_discovery_bounds to
      enable limiting discovery of spatial entities to within a sphere, box, or
      frustum.
      (internal MR 3520)
    • New vendor extension specification: XR_BD_body_tracking_auxiliary_metrics
      provides additional data about body tracking state and the ability to trigger
      the runtime to begin its calibration process.
      (internal MR 3756)
    • New vendor extension specification: XR_META_hand_tracking_frequency_hint
      providing a way for applications to inform the runtime they would prefer higher
      frequency, lower latency tracking with tradeoffs.
      (internal MR 4110)
    • New vendor extension specification:
      XR_META_hand_tracking_unextrapolated_poses for use by specialized
      applications that may have additional context for hand tracking extrapolation
      not available to the runtime.
      (internal MR 4113)
    • New vendor extension specification: XR_META_hand_tracking_wide_motion_mode2
      adding another hand tracking data source that performs wider-range tracking
      even outside of the view of the cameras.
      (internal MR 4114)
    • New vendor extension specification: XR_ANDROID_google_cloud_auth to give a
      way for apps to send their Google Cloud auth info to the runtime.
      (internal MR 4200)
    • New vendor extension specification: XR_ANDROID_geospatial to convert a WGS84
      GeoPose to an XrPosef and vice-versa using vendor cloud services.
      (internal MR 4201)
    • New vendor extension specification: XR_ANDROID_geospatial_anchor to provide
      geospatial & surface anchors.
      (internal MR 4214)
    • New vendor extension specifications: XR_BD_dynamic_object_tracking vendor
      spatial sensing related extension, with related XR_BD_dynamic_object_keyboard
      (for tracking a computer keyboard) and XR_BD_dynamic_object_mouse (for
      tracking a computer mouse) extensions.
      (internal MR 3944)
  • Registry
    • Fix: Typos in enum value names for XrTrackingOptimizationSettingsHintQCOM.
      Original names left as aliases for source compatibility.
      (internal MR 4186)
    • Improvement: XR_LIST_FUNCTIONS_ macros in the reflection header are now
      generated for all features, even those lacking functions.
      (internal MR 4329)
    • New vendor extension: XR_ANDROID_spatial_discovery_bounds
      (internal MR 3520)
    • New vendor extension: XR_BD_body_tracking_auxiliary_metrics
      (internal MR 3756)
    • New vendor extension: XR_BD_dynamic_object_tracking
      (internal MR 3944)
    • New vendor extension: XR_BD_dynamic_object_keyboard
      (internal MR 3944)
    • New vendor extension: XR_BD_dynamic_object_mouse
      (internal MR 3944)
    • New vendor extension: XR_META_hand_tracking_frequency_hint
      (internal MR 4110)
    • New vendor extension: XR_META_hand_tracking_unextrapolated_poses
      (internal MR 4113)
    • New vendor extension: XR_META_hand_tracking_wide_motion_mode2
      (internal MR 4114)
    • New vendor extension: XR_ANDROID_google_cloud_auth
      (internal MR 4200)
    • New vendor extension: XR_ANDROID_geospatial
      (internal MR 4201)
    • New vendor extension: XR_ANDROID_geospatial_anchor
      (internal MR 4214)
    • Schematron: Add exception for the comments of a behavior-only
      XrSpatialComponentTypeEXT.
      (internal MR 4353)

OpenXR Specification (Source) 1.1.60

Choose a tag to compare

@rpavlik rpavlik released this 20 May 23:23
release-1.1.60

OpenXR Specification 1.1.60 (2026-05-20)

This release features a new multi-vendor extension and a number of quality and
correctness fixes to the specification. A number of extensions have also been
marked deprecated.

OpenXR Specification (Source) 1.1.59

Choose a tag to compare

@rpavlik rpavlik released this 30 Apr 19:31
release-1.1.59

OpenXR Specification 1.1.59 (2026-04-30)

This release provides a usability improvement for the HTML spec: anchors for
symbols are now at the top of the relevant docs, rather than at the C
declaration. Clicking links in the spec will now bring you to a more useful
location in the spec so you do not miss any of the information. There is also a
new multi-vendor extension, as well as several new vendor extensions, and the
usual mix of smaller changes and improvements.

  • Specification
    • Improvement: Clean up formatting for XR_EXT_hand_tracking_data_source.
      (internal MR 4218)
    • Improvement: Fix EYES_LOOK blend shape descriptions in XR_FB_face_tracking2
      specification.
      (internal MR 4232,
      internal issue 2515,
      OpenXR-Docs issue 189)
    • Improvement: Document eye rotation angles for EYES_LOOK blend shapes for
      XR_FB_face_tracking2.
      (internal MR 4233,
      internal issue 2514,
      OpenXR-Docs issue 188)
    • Improvement: Unify permission text for ByteDance spatial APIs using a shared
      spec include.
      (internal MR 4238)
    • Improvement: Move link destination for symbols (function, structure, etc.) to
      top of the marked documentation.
      (internal MR 4272,
      internal MR 4282)
    • Improvement: Change sample haptic duration from 300ns to 300ms.
      (internal MR 4281,
      internal issue 1663)
    • Improvement: Remove language describing how to enable extensions from extension
      text where it duplicated implicit validity language.
      (internal MR 4285)
    • New multi-vendor extension specification: XR_EXT_stationary_reference_space,
      providing a reference space focused solely on remaining stationary to the best
      of the runtime's ability.
      (internal MR 3021)
    • New vendor extension specification: XR_META_boundary_visibility providing the
      ability for the application to suggest hiding or showing the play space
      boundary.
      (internal MR 3249)
    • New vendor extension specification: XR_META_face_tracking_visemes exposing
      visemes data in face tracking, as an alternate or additional output besides
      blend shapes.
      (internal MR 3424)
    • New vendor extension specification: XR_META_spatial_entity_room_mesh provides
      access to room mesh and associated metadata when also using the
      XR_FB_spatial_entity vendor extension.
      (internal MR 3530)
    • New vendor extension specification: XR_ANDROID_eye_tracking for access to the
      position and orientation of the user's eyes.
      (internal MR 3773)
    • New vendor extension specification: XR_ANDROID_recommended_resolution to
      notify the application when the recommended resolution changes.
      (internal MR 3840)
    • New vendor extension specification: XR_ANDROID_light_estimation to query
      lighting information from the user's environment.
      (internal MR 3879)
    • Update vendor specification: Revision 5 of XR_FB_passthrough
      (internal MR 3682)
  • Registry

OpenXR Specification (Source) 1.1.58

Choose a tag to compare

@rpavlik rpavlik released this 31 Mar 22:52
release-1.1.58

OpenXR Specification 1.1.58 (2026-03-31)

This release features several fixes and improvements to the specification as
well as a number of new extensions. The most notable are the two new ratified
multi-vendor extensions, XR_EXT_view_configuration_views_change and
XR_EXT_interaction_profile_battery_state_display.

  • Specification
    • Change: Update the extension process document to include an alternate method of
      distinguishing experimental extensions during their development.
      (internal MR 3678)
    • Clarify: In XR_EXT_spatial_entity, clarify that update snapshot must not
      included unlisted entities.
      (internal MR 4149)
    • Fix: Typo in XR_EXT_hand_tracking_data_source Issue 2, referencing the
      incorrect structure.
      (internal MR 4170)
    • Fix: Correct link for MR number reservation from extension process to style
      guide.
      (internal MR 4183,
      internal issue 2688)
    • Fix: Two-call idiom links in some extensions.
      (internal MR 4185)
    • Improvement: Fix syntax highlighting of example C++ code in the spec.
      (internal MR 4181)
    • Improvement: Add links to XrSystemProperties next chain usage.
      (internal MR 4195)
    • New ratified multi-vendor extension specification:
      XR_EXT_view_configuration_views_change providing an event to notify the app
      of manual or infrequent changes to views (usually recommended resolutions).
      (internal MR 711,
      internal issue 619)
    • New ratified multi-vendor extension specification:
      XR_EXT_interaction_profile_battery_state_display providing access to limited
      battery state information for display purposes only.
      (internal MR 3528,
      internal issue 1339,
      internal issue 1905)
    • New vendor extension specification: XR_QCOM_hand_tracking_gesture adding
      vendor-specific additional data to the hand tracking extension.
      (internal MR 2572)
    • New vendor extension specification: XR_META_body_tracking_fidelity providing
      applications with the ability to influence performance vs. quality tradeoffs in
      body tracking.
      (internal MR 2962)
    • New vendor extension specification: XR_META_spatial_entity_semantic_label
      defines semantic labels to describe semantic meanings of an associated spatial
      entity, within the XR_FB_spatial_entity framework.
      (internal MR 3529)
    • New vendor extension specification: XR_ANDROID_performance_metrics to
      enumerate and query various performance metrics counters of the current XR
      device.
      (internal MR 3607)
    • New vendor extension specification: XR_ANDROID_mouse_interaction introduces a
      new vendor-specific interaction profile for mouse devices.
      (internal MR 3608)
    • New vendor extension specification: XR_ANDROID_unbounded_reference_space
      provides a new vendor-specific reference space type.
      (internal MR 3624)
    • New vendor extension specification:
      XR_ANDROID_composition_layer_passthrough_mesh enables applications to project
      passthrough textures onto arbitrary geometry.
      (internal MR 3625)
    • New vendor extension specification: XR_META_environment_raycast allowing
      applications to perform raycast operations against the surrounding physical
      environment.
      (internal MR 3758)
    • New vendor extension specification: XR_ANDROID_trackables_qr_code allowing
      applications to detect and track QR codes in the user's environment, in the
      XR_ANDROID_trackables framework.
      (internal MR 3772)
    • New vendor extension specification: XR_BD_spatial_audio_rendering allowing
      applications to render spatial audio in a 3D space.
      (internal MR 3794)
    • New vendor extension specification: XR_ANDROID_scene_meshing to track the
      triangle mesh representation of the user's environment.
      (internal MR 3872)
    • New vendor extension specification: XR_META_tile_properties_hint allowing
      applications to provide the tile properties of a render pass as a hint to the
      OpenXR runtime.
      (internal MR 3885)
    • New vendor extension specification: XR_ANDROID_spatial_object_tracking
      allowing applications to track objects in the user's environment, within the
      XR_EXT_spatial_entity framework.
      (internal MR 3992)
    • New vendor extension specification: XR_ANDROID_spatial_discovery_raycast to
      discover spatial entities via raycast hit test.
      (internal MR 3993)
    • New vendor extension specification: XR_ANDROID_spatial_entity_bound_anchor
      allowing applications to attach anchors to spatial entities, within the
      XR_EXT_spatial_entity framework.
      (internal MR 3994)
    • New vendor extension specification: XR_ANDROID_spatial_component_subsumed_by
      to provide a component on spatial entities that get subsumed by another entity,
      within the XR_EXT_spatial_entity framework.
      (internal MR 4125)
    • New vendor extension specification: XR_ANDROID_spatial_anchor_space to create
      an XrSpace that represents a spatial anchor, within the XR_EXT_spatial_entity
      framework.
      (internal MR 4132)
  • Registry
Read more

OpenXR Specification (Source) 1.1.57

Choose a tag to compare

@rpavlik rpavlik released this 13 Feb 16:45
release-1.1.57

OpenXR Specification 1.1.57 (2026-02-12)

This release features a few cleanups and clarifications, an addition to the
Spatial Entities specifications, a vendor extension, and tooling improvements.

Note that specification releases 1.1.55 and 1.1.56 were skipped to keep up with
a monthly increment for the patch version component.

  • Specification
    • Clarify: Add grip-surface/palm and hand interaction snippets to Samsung Odyssey
      controller extension.
      (internal MR 2170)
    • Fix: XR_KHR_extended_struct_name_lengths string length can be up to 256
      bytes.
      (internal MR 4126)
    • Improvement: Update and optimize CSS for improved browser performance.
      (internal MR 4054)
    • Improvement: Update specification layout and formatting for
      XR_QCOM_tracking_optimization_settings.
      (internal MR 4064)
    • Improvement: Add guidelines for defining semantic labels in the spatial entity
      framework.
      (internal MR 4081)
    • Improvement: Add known issues to Issues section for
      XR_OCULUS_audio_device_guid.
      (internal MR 4102)
    • New vendor extension specification: XR_ANDROID_trackables_image providing
      vendor-specific tracking of planar images as specified by sets of input
      reference images.
      (internal MR 4069)
  • Registry

OpenXR Specification (Source) 1.1.54

Choose a tag to compare

@rpavlik rpavlik released this 03 Dec 17:09
release-1.1.54

OpenXR Specification 1.1.54 (2025-12-02)

This release contains a number of specification clarifications and fixes, in
addition to improved guidance and tooling for those extending OpenXR, among
other changes.

OpenXR Specification (Source) 1.1.53

Choose a tag to compare

@rpavlik rpavlik released this 14 Oct 21:41
release-1.1.53

OpenXR Specification 1.1.53 (2025-10-14)

This release contains three new vendor extensions and a handful of spec fixes
and clarifications.

  • Specification
    • Clarify: In XR_MND_headless, no xrGet...GraphicsRequirements call is
      required if you create a headless session. Bump version.
      (internal MR 3961)
    • Clarify: Mark XR_MSFT_hand_interaction as promoted to
      XR_EXT_hand_interaction.
      (internal MR 4021)
    • Fix: Correct XR_ANDROID_trackables_object orientation.
      (internal MR 4018)
    • Fix: Typo in top level /user paths link in XR_EXT_interaction_render_model.
      (internal MR 4034)
    • Fix: Typo in XR_EXT_spatial_entity and XR_EXT_plane_detection.
      (internal MR 4038)
    • Fix: Formatting issue in the version 1.1 appendix.
      (internal MR 4042)
    • Fix: Correct the description of the 1.1-khr spec artifacts in the copyright-
      related preamble.
      (internal MR 4044)
    • New vendor extension specification: XR_BD_facial_simulation.
      (internal MR 2925)
    • New vendor extension specification: XR_ANDROID_face_tracking.
      (internal MR 3613)
    • New vendor extension specification: XR_BD_ultra_controller_interaction.
      (internal MR 3789)
  • Registry
    • Fix: Bump XR_ANDROID_trackables_object version for fix to orientation.
      (internal MR 4018)
    • New vendor extension: XR_BD_facial_simulation for vendor-specific access to
      facial expressions.
      (internal MR 2925)
    • New vendor extension: XR_BD_ultra_controller_interaction for PICO Ultra
      controller interaction profile.
      (internal MR 3789)
    • New vendor extension specification: XR_ANDROID_face_tracking for vendor-
      specific access to facial expressions.
      (internal MR 3613)
    • Update: Bump version of XR_MND_headless for clarification.
      (internal MR 3961)

OpenXR Specification (Source) 1.1.52

Choose a tag to compare

@rpavlik rpavlik released this 19 Sep 21:44
release-1.1.52

OpenXR Specification 1.1.52 (2025-09-19)

This release adds a new ratified Khronos extension, which defines a new
interaction profile intended for fallback use. It also announces the
ratification of several existing EXT extensions, fixes issues in the XML
registry, adds a new vendor extension, and modifies a recent vendor extension.

  • Specification
    • New ratified Khronos extension specification: XR_KHR_generic_controller providing a
      featureful fallback interaction profile that maps easily (and in defined ways)
      to popular controllers.
      (internal MR 3018)
    • New vendor extension specification: XR_META_spatial_entity_discovery
      providing for vendor-specific spatial entity retrieval in large areas.
      (internal MR 2880,
      internal MR 4001)
    • Change: Revert XrTrackablePlaneANDROID::vertexCountOutput to a pointer, add
      note explaining that it does not match convention, and increment extension
      version number.
      (internal MR 3998)
    • Fix: Update XR_EXT_hand_interaction extension version to 2 for clarity,
      corresponding to adding XML for missing grip_surface paths for
      "/interaction_profiles/ext/hand_interaction_ext" in xr.xml.
      (internal MR 3963)
  • Registry
    • New ratified Khronos extension: XR_KHR_generic_controller
      (internal MR 3018)
    • Update: Ratified XR_EXT_debug_utils
      (internal MR 3899)
    • Update: Ratified XR_EXT_render_model
      (internal MR 3900)
    • Update: Ratified XR_EXT_interaction_render_model
      (internal MR 3901)
    • New vendor extension: XR_META_spatial_entity_discovery.
      (internal MR 2880,
      internal MR 4001)
    • Change: Revert XrTrackablePlaneANDROID::vertexCountOutput to a pointer, and
      increment extension version number.
      (internal MR 3998)
    • Chore: Reserve numbers for extensions.
      (internal MR 4004)
    • Fix: Add XML for missing grip_surface paths for
      "/interaction_profiles/ext/hand_interaction_ext". Note that these paths were
      already listed in the spec prose. Update XR_EXT_hand_interaction extension
      version to 2 for clarity.
      (internal MR 3963)
    • Fix: Mark a few structure members that are bitmasks as optional, to match prose
      and/or usage intent.
      (internal MR 3973)
    • Fix: Mark XrCompositionLayerPassthroughFB.space as optional to match spec
      prose.
      (internal MR 3973)
    • Fix: Add XML for missing palm_ext/pose and grip_surface/pose paths for
      "/interaction_profiles/logitech/mx_ink_stylus_logitech". Note that these paths
      were already listed in the spec prose.
      (internal MR 3996)