Releases: KhronosGroup/OpenXR-Docs
Release list
OpenXR Specification (Source) 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_renderingto 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_lengthsadds a new variant of the
xrResultToString()function which supportsXrResultname 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_estimationprovides
access to estimated environmental lighting through vendor spatial sensing
framework.
(internal MR 3814) - New vendor extension specification:
XR_BD_camera_imageprovides access to
device camera images.
(internal MR 4089,
internal MR 4473) - New vendor extension specification:
XR_SONY_hdr_metadataallowing
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.pythat 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)
- New ratified multi-vendor extension specifications:
- Registry
- New ratified Khronos extension:
XR_KHR_extended_result_name_lengths
(internal MR 3964) - New ratified multi-vendor extensions:
XR_EXT_spatial_container,
XR_EXT_spatial_container_self_rendering
(internal MR 3712,
internal MR 4472) - New multi-vendor extension:
XR_EXT_spatial_image_tracking
(internal MR 3805) - New vendor extension:
XR_BD_spatial_light_estimation
(internal MR 3814) - New vendor extension:
XR_BD_camera_image
(internal MR 4089) - New vendor extension:
XR_SONY_hdr_metadata
(internal MR 4172) - Change: Add new semantic definitions including keyboard, mouse, and laptop in
XrSemanticLabelBD.
(internal MR 4221) - Chore: Reserve extension numbers.
(internal MR 4420,
internal MR 4421) - Fix: Missing comments for
XrResulterror codes added by
XR_ANDROID_google_cloud_auth,XR_ANDROID_geospatial, and
XR_ANDROID_geospatial_anchor.
(internal MR 4438) - Fix: Always output forward slashes in relative paths when merging registry.
(internal MR 4451)
- New ratified Khronos extension:
OpenXR Specification (Source) 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_spacesspecification sample code that initialized
XrSpaceLocationsKHRwith the wrong structure type,
XR_TYPE_SPACES_LOCATE_INFO_KHRinstead ofXR_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.pyfor types that are not
(explicitly) included inxr.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_spaceallowing
applications to specify the color space of swapchain images and to enumerate
the color spaces supported by the session.
(internal MR 4171)
- Fix: Correct
- Registry
- Change: XML registry
xr.xmlis now checked in after being constructed from
xr.fragmented.xmland multiple per-extension XML file fragments, for reduced
conflicts during development. The schema ofxr.xmlhas not changed. Be sure
to runspecification/scripts/merge-registry.shafter editing
xr.fragmented.xmlor one of the fragments, as most tooling still uses the
merged XML registry.
(internal MR 4161) - Chore: Register
DXRauthor 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_REACHEDas an valid return for
xrAcquireEnvironmentDepthImageMETAmatching API description.
(internal MR 4414) - Improvement: Move
XR_ANDROID_trackablesto 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)
- Change: XML registry
OpenXR Specification (Source) 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_entityspec
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_boundsto
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_posesfor 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_authto give a
way for apps to send their Google Cloud auth info to the runtime.
(internal MR 4200) - New vendor extension specification:
XR_ANDROID_geospatialto convert a WGS84
GeoPose to anXrPosefand vice-versa using vendor cloud services.
(internal MR 4201) - New vendor extension specification:
XR_ANDROID_geospatial_anchorto provide
geospatial & surface anchors.
(internal MR 4214) - New vendor extension specifications:
XR_BD_dynamic_object_trackingvendor
spatial sensing related extension, with relatedXR_BD_dynamic_object_keyboard
(for tracking a computer keyboard) andXR_BD_dynamic_object_mouse(for
tracking a computer mouse) extensions.
(internal MR 3944)
- Fix: Typos in enum value names for
- 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)
- Fix: Typos in enum value names for
OpenXR Specification (Source) 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.
- Specification
- New multi-vendor extension specification:
XR_EXT_haptic_parametricallows
triggering high-fidelity haptic vibrations.
(internal MR 3307) - Change: Document
XR_ANDROID_trackablesand its child extensions as deprecated
by variousXR_EXTandXR_ANDROIDspatial entity extensions, with
deprecation notes in the specification.
(internal MR 4228) - Fix: Correct documentation for
VERY_STRICTinspecification/Makefile.
(internal MR 4294,
internal issue 2742) - Fix: Add missing ref pages for constants defined in
XR_ANDROID_eye_tracking
andXR_ANDROID_face_tracking.
(internal MR 4303,
internal issue 2741) - Fix: Several broken internal cross-references in extensions.
(internal MR 4328) - Improvement: Clean up specification for
XR_EXT_eye_gaze_interaction, and
resolve a question previously left unspecified.
(internal MR 3498) - Improvement: Improve consistency of struct initialization patterns in adoc
sample code, using designated initializers for clarity.
(internal MR 4231,
internal MR 4240,
internal MR 4243) - Improvement: Enable warnings as errors in AsciiDoctor builds.
(internal MR 4294,
internal issue 2742) - Improvement: Fix mouse interaction profile name & clarify scroll component in
theXR_ANDROID_mouse_interactionextension.
(internal MR 4297) - Improvement: Silence warnings when generating style guide
(internal MR 4300) - Scripts: Replace
findBareNormatives.shwithfindBareNormatives.pyto make
it easier to run cross-platform and easier to build on top of, and populate a
bare_normatives_allowlist.txtfile to list (current) known exceptions to bare
normative rules.
(internal MR 4286,
internal MR 4320) - Scripts: Add
findBareNormatives.pytomake check-spec-links.
(internal MR 4286,
internal MR 4286) - Style Guide: Update schema to document deprecation expressions referring to
more than one extension, as well as the<extend type="command">tag for
extending return codes for a function.
(internal MR 4228,
internal MR 4228,
internal issue 2494,
internal MR 4009)
- New multi-vendor extension specification:
- Registry
- New multi-vendor extension:
XR_EXT_haptic_parametric
(internal MR 3307) - Change: Deprecate HoloLens 2 related extensions.
(internal MR 4133) - Change: Mark
XR_ANDROID_trackablesand its child extensions as deprecated by
variousXR_EXTandXR_ANDROIDspatial entity extensions.
(internal MR 4228) - Fix: Add comment for enum value
XR_SPACE_COMPONENT_TYPE_ROOM_MESH_METAin
xr.xml.
(internal MR 4292,
internal issue 2740) - Fix: Add comment for result value
XR_BOUNDARY_VISIBILITY_SUPPRESSION_NOT_ALLOWED_METAinxr.xml.
(internal MR 4293,
internal issue 2739) - Fix: Mark
XrSessionCreateInfoOverlayEXTX::createFlagsas optional.
(internal MR 4302) - Fix: Update
XrFoveationEyeTrackedProfileCreateInfoMETAto markflagsas
optional
(internal MR 4317,
internal MR 4317) - Improvement: Add schematron validation for
optionalrequired for empty bit
flags.
(internal MR 4317,
internal issue 2745) - Scripts: Handle deprecation expressions referring to multiple extensions.
(internal MR 4228)
- New multi-vendor extension:
OpenXR Specification (Source) 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_LOOKblend shape descriptions inXR_FB_face_tracking2
specification.
(internal MR 4232,
internal issue 2515,
OpenXR-Docs issue 189) - Improvement: Document eye rotation angles for
EYES_LOOKblend 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_visibilityproviding 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_visemesexposing
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_meshprovides
access to room mesh and associated metadata when also using the
XR_FB_spatial_entityvendor extension.
(internal MR 3530) - New vendor extension specification:
XR_ANDROID_eye_trackingfor access to the
position and orientation of the user's eyes.
(internal MR 3773) - New vendor extension specification:
XR_ANDROID_recommended_resolutionto
notify the application when the recommended resolution changes.
(internal MR 3840) - New vendor extension specification:
XR_ANDROID_light_estimationto query
lighting information from the user's environment.
(internal MR 3879) - Update vendor specification: Revision 5 of
XR_FB_passthrough
(internal MR 3682)
- Improvement: Clean up formatting for
- Registry
- Chore: Reserve extension numbers and adjust previous reservations.
(internal MR 4266,
internal MR 4276,
internal MR 4282,
internal MR 4253) - Improvement: Enforce that essentially all functions must be able to return
XR_ERROR_RUNTIME_FAILURE.
(internal MR 3611,
internal issue 2345) - New multi-vendor extension:
XR_EXT_stationary_reference_space
(internal MR 3021) - New vendor extension:
XR_META_boundary_visibility
(internal MR 3249) - New vendor extension:
XR_META_face_tracking_visemes
(internal MR 3424) - New vendor extension:
XR_META_spatial_entity_room_mesh
(internal MR 3530) - New vendor extension:
XR_ANDROID_eye_tracking
(internal MR 3773) - New vendor extension:
XR_ANDROID_recommended_resolution
(internal MR 3840) - New vendor extension:
XR_ANDROID_light_estimation.
(internal MR 3879) - Schematron: Improvement: Add validation for ordering of structs in
xr.xml.
(internal MR 4251) - Schematron: Bump schXslt Schematron checker version and fix error in wrapper
script.
(internal MR 4288) - Update vendor specification: Revision 5 of
XR_FB_passthrough
(internal MR 3862)
- Chore: Reserve extension numbers and adjust previous reservations.
OpenXR Specification (Source) 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_sourceIssue 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
XrSystemPropertiesnext chain usage.
(internal MR 4195) - New ratified multi-vendor extension specification:
XR_EXT_view_configuration_views_changeproviding 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_displayproviding 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_gestureadding
vendor-specific additional data to the hand tracking extension.
(internal MR 2572) - New vendor extension specification:
XR_META_body_tracking_fidelityproviding
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 theXR_FB_spatial_entityframework.
(internal MR 3529) - New vendor extension specification:
XR_ANDROID_performance_metricsto
enumerate and query various performance metrics counters of the current XR
device.
(internal MR 3607) - New vendor extension specification:
XR_ANDROID_mouse_interactionintroduces 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_meshenables applications to project
passthrough textures onto arbitrary geometry.
(internal MR 3625) - New vendor extension specification:
XR_META_environment_raycastallowing
applications to perform raycast operations against the surrounding physical
environment.
(internal MR 3758) - New vendor extension specification:
XR_ANDROID_trackables_qr_codeallowing
applications to detect and track QR codes in the user's environment, in the
XR_ANDROID_trackablesframework.
(internal MR 3772) - New vendor extension specification:
XR_BD_spatial_audio_renderingallowing
applications to render spatial audio in a 3D space.
(internal MR 3794) - New vendor extension specification:
XR_ANDROID_scene_meshingto track the
triangle mesh representation of the user's environment.
(internal MR 3872) - New vendor extension specification:
XR_META_tile_properties_hintallowing
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_entityframework.
(internal MR 3992) - New vendor extension specification:
XR_ANDROID_spatial_discovery_raycastto
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_entityframework.
(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 theXR_EXT_spatial_entityframework.
(internal MR 4125) - New vendor extension specification:
XR_ANDROID_spatial_anchor_spaceto create
an XrSpace that represents a spatial anchor, within theXR_EXT_spatial_entity
framework.
(internal MR 4132)
- Change: Update the extension process document to include an alternate method of
- Registry
- Change: Mark
XR_FB_space_warpas deprecated byXR_EXT_frame_synthesis,
which provides the same functionality with a slightly modified interface.
(internal MR 4173,
internal issue 2469) - Chore: Reserve extension numbers.
(internal MR 4204) - Fix: Mark
XR_FB_touch_controller_proximityas obsoleted by OpenXR 1.1.
(internal MR 4191,
internal issue 2599) - Improvement: Add command return code checks in
xml_consistency.pyfor
specific spatial entity input types.
(internal MR 4151) - New ratified multi-vendor extension:
XR_EXT_view_configuration_views_change
(internal MR 711,
internal issue 619) - New ratified multi-vendor extension:
XR_EXT_interaction_profile_battery_state_display.
(internal MR 3528,
internal issue 1339,
internal issue 1905) - New vendor extension:
XR_QCOM_hand_tracking_gesture
(internal MR 2572) - New vendor extension:
XR_META_body_tracking_fidelity
(internal MR 2962) - New vendor extension:
XR_META_spatial_entity_semantic_label
(internal MR 3529) - New vendor extension:
XR_ANDROID_performance_metrics
(internal MR 3607) - New vendor extension:
XR_ANDROID_mouse_interaction
(internal MR 3608) - New vendor extension:
XR_ANDROID_unbounded_reference_space
(internal MR 3624) - New vendor extension:
XR_ANDROID_composition_layer_passthrough_mesh
(internal MR 3625) - New vendor extension:
XR_META_environment_raycast
(internal MR 3758) - New vendor extension:
XR_ANDROID_trackables_qr_code
(internal MR 3772) - New vendor extension:
XR_BD_spatial_audio_rendering
(internal MR 3794) - New vendor extension:
XR_ANDROID_scene_meshing
([internal MR 3872](https://gitlab.k...
- Change: Mark
OpenXR Specification (Source) 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_lengthsstring 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_imageproviding
vendor-specific tracking of planar images as specified by sets of input
reference images.
(internal MR 4069)
- Clarify: Add grip-surface/palm and hand interaction snippets to Samsung Odyssey
- Registry
- Change: Update tooling to properly support extending allowable return codes
from extensions.
(internal MR 4009,
internal issue 2494) - Chore: Reorder function return codes to alphabetic (with
XR_SUCCESSpulled to
the front).
(internal MR 3979) - Chore: Reserve extensions.
(internal MR 4157,
internal MR 4162) - Fix:
XR_KHR_extended_struct_name_lengthsstring length can be up to 256
bytes. (The prose has been modified to match the XML specification.)
(internal MR 4126,
internal issue 2654) - New vendor extension:
XR_ANDROID_trackables_image.
(internal MR 4069) - Schematron: Add validation for return code ordering.
(internal MR 3979) - Schematron: Add validation for semantic label enums defined for the spatial
entity framework.
(internal MR 4081) - Update: Mark
XR_EXT_plane_detectionas deprecated by
XR_EXT_spatial_plane_tracking.
(internal MR 4057,
internal issue 2625)
- Change: Update tooling to properly support extending allowable return codes
OpenXR Specification (Source) 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.
- Specification
- Change: Deprecate the Wayland part of
XR_KHR_opengl_enable.
(internal MR 4052,
OpenXR-SDK-Source issue 282,
internal issue 1634,
internal issue 2559) - Change: Update the vendor extension review process.
(internal MR 4056) - Clarification: Add more information in the 1.1 appendix about the
thumb_resting_surfaces location
(internal MR 3603) - Clarify: Specify what the runtime may do in a completion function of an
XrFutureEXTinXR_EXT_future.
(internal MR 3796,
internal MR 4028) - Clarify:
xrDestroySwapchainin practice requires the application to do some
sync primitive CPU waiting. (CTS is now enforcing that the runtime is not doing
its own waiting there.)
(internal MR 4030) - Clarify: Describe why
xrCreateSpatialAnchorEXThas 2 outputs.
(internal MR 4033,
internal MR 4021) - Fix: Removed clip space specification from all graphics api extensions.
(internal MR 3765) - Fix: Add comment boxes for
XrSpatialCapabilityEXTand
XrSpatialCapabilityFeatureEXT.
(internal MR 4084) - Improvement: Replace the recommendation for manual "New Types", etc. with
interface include and make respective samples cleaner in styleguide.
(internal MR 4035) - Improvement: Adjust image assets to reduce spec output file size.
(internal MR 4050,
internal MR 4051,
internal MR 4055) - Improvement: Add missing heading for Mesh3D component in
XR_EXT_spatial_entity.
(internal MR 4088,
internal MR 4056) XR_META_environment_depth: AddXrEnvironmentDepthImageTimestampMETA.
(internal MR 4024)
- Change: Deprecate the Wayland part of
- Registry
- Change: Deprecate the Wayland part of
XR_KHR_opengl_enableand bump version.
(internal MR 4052,
OpenXR-SDK-Source issue 282,
internal issue 1634,
internal issue 2559) - Chore: Reserve extensions.
(internal MR 4067,
internal MR 4079,
internal MR 4098,
internal MR 4099,
internal MR 4100) - Fix: Correctly define
XR_EXT_dpad_bindingpaths for
/interaction_profiles/bytedance/pico_ultra_controller_bd in XML.
(internal MR 4049) - Improvement: Add description for
XR_SPACE_COMPONENT_TYPE_TRIANGLE_MESH_META.
(internal MR 4070) - Schematron: Add validation to ensure bitmasks are non-plural before
Flags/FlagBits.
(internal MR 2678) - Schematron: Add validation to check additional scenarios of
nextpointer
const-ness.
(internal MR 2740) - Schematron: Add validation for interaction profile extension binding additions.
(internal MR 3982) - Schematron: Remove unneeded exception from "Param/member naming conventions:
camelCase" pattern.
(internal MR 4072) - Schematron: Fix check for multiple arrays bounded by the same
lenparam.
(internal MR 4077) - Schematron: Add validation for the comment attribute of
XrSpatialComponentTypeEXTvalues. The comment must reference the list and
data structs for the component.
(internal MR 4083) - Schematron: Add validation for the comment attribute of
XrSpatialCapabilityFeatureEXTvalues. The comment must have references to the
feature's config structs.
(internal MR 4084) - Schematron: Add check for orphaned structs, enforcing
structextendsor
parentstructwhen appropriate.
(internal MR 4091,
internal MR 4094) - Update: Bump XR_EXT_future version due to clarifying what the runtime may do in
a completion function of anXrFutureEXT.
(internal MR 3796,
internal MR 4028) - Update: Add
XrEnvironmentDepthImageTimestampMETAto
XR_META_environment_depth, update spec version to 2.
(internal MR 4024)
- Change: Deprecate the Wayland part of
OpenXR Specification (Source) 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, noxrGet...GraphicsRequirementscall is
required if you create a headless session. Bump version.
(internal MR 3961) - Clarify: Mark
XR_MSFT_hand_interactionas promoted to
XR_EXT_hand_interaction.
(internal MR 4021) - Fix: Correct
XR_ANDROID_trackables_objectorientation.
(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_entityandXR_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-khrspec 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)
- Clarify: In
- Registry
- Fix: Bump
XR_ANDROID_trackables_objectversion for fix to orientation.
(internal MR 4018) - New vendor extension:
XR_BD_facial_simulationfor vendor-specific access to
facial expressions.
(internal MR 2925) - New vendor extension:
XR_BD_ultra_controller_interactionfor PICO Ultra
controller interaction profile.
(internal MR 3789) - New vendor extension specification:
XR_ANDROID_face_trackingfor vendor-
specific access to facial expressions.
(internal MR 3613) - Update: Bump version of
XR_MND_headlessfor clarification.
(internal MR 3961)
- Fix: Bump
OpenXR Specification (Source) 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_controllerproviding 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::vertexCountOutputto a pointer, add
note explaining that it does not match convention, and increment extension
version number.
(internal MR 3998) - Fix: Update
XR_EXT_hand_interactionextension version to2for clarity,
corresponding to adding XML for missinggrip_surfacepaths for
"/interaction_profiles/ext/hand_interaction_ext" inxr.xml.
(internal MR 3963)
- New ratified Khronos extension specification:
- 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::vertexCountOutputto a pointer, and
increment extension version number.
(internal MR 3998) - Chore: Reserve numbers for extensions.
(internal MR 4004) - Fix: Add XML for missing
grip_surfacepaths for
"/interaction_profiles/ext/hand_interaction_ext". Note that these paths were
already listed in the spec prose. UpdateXR_EXT_hand_interactionextension
version to2for 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.spaceas optional to match spec
prose.
(internal MR 3973) - Fix: Add XML for missing
palm_ext/poseandgrip_surface/posepaths for
"/interaction_profiles/logitech/mx_ink_stylus_logitech". Note that these paths
were already listed in the spec prose.
(internal MR 3996)
- New ratified Khronos extension: