Note: New platform features will not be added to the Oculus XR Plugin, and features released in Meta XR SDK versions v74+ might not be compatible with the Oculus XR Plugin. The Unity OpenXR Plugin is the recommended provider plugin going forward. If you are developing with SDKs on v74+, use Unity 6+ with the Unity OpenXR Plugin instead.
Prior to OpenXR version 1.9, setting the tracking origin STAGE requires a recenter before the world origin is updated.
Install the Unity OpenXR Plugin
For projects built on Unity 6+ that use Meta XR SDKs v74+, install the Unity OpenXR Plugin.
To install the OpenXR provider plugin:
Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
Select XR Plug-in Management in the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Windows, Mac, Linux settings tab, select OpenXR.
In the Android settings tab, select OpenXR.
Close the Project Settings window.
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
At the top left of the window, select Packages: and change the selection to Packages: In Project.
In the list of packages in the left menu, verify that there is a check mark beside the Unity OpenXR Plugin, indicating that the package is installed.
Note: Installing an XR plugin does not download and import the Meta XR SDKs in to your project. Make sure you download the Meta XR SDKs you need from the Unity Asset Store.
Note: This action will install ARFoundation and OpenXR packages as dependencies into your project.
Oculus XR Plugin
Note: New platform features will not be added to the Oculus XR Plugin, and features released in Meta XR SDK versions v74+ might not be compatible with the Oculus XR Plugin. The Unity OpenXR Plugin is the recommended provider plugin going forward. If you are developing with SDKs on v74+, use Unity 6+ with the Unity OpenXR Plugin instead.
Unity uses the Oculus XR Plugin to facilitate XR development on Meta Quest headsets. The Oculus XR Plugin exposes settings for common lifecycle management and runtime settings such as rendering modes, depth buffer sharing, and latency optimization.
Meta XR Core SDK contains the OVRPlugin, which provides built-in editor support and several additional features. The OVRPlugin, combined with Unity’s Oculus XR Plugin, allows Unity to talk to the OpenXR, VRAPI, and CAPI backends on Meta Quest headsets. To accelerate OpenXR adoption and allow you to seamlessly target a wide range of Meta AR/VR headsets using the same API, Meta has made OpenXR runtime the default backend. Starting with the Meta XR SDKs version 31, all new features are available on the OpenXR backend only.
Unity’s Oculus XR Plugin provides the base functionality for getting the XR application running on the Meta Quest headset. We recommend also using the Meta XR Core SDK package if the project requires the latest up-to-date features. Meta XR Core SDK package contains the latest version of OVRPlugin as well as handy C# scripts that expose Meta Quest features that are not yet provided through Unity’s APIs. For example, advanced features such as presence platform, voice, hand tracking, interaction, and many more are surfaced through the Meta XR Core SDK and not through Unity API.
Install the Oculus XR Plugin
For projects built on Unity versions < 6 that use Meta XR SDKs < v74, install the Oculus XR Plugin.
To install the Oculus XR provider plugin:
Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
Select XR Plug-in Management in the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Windows, Mac, Linux settings tab, select Oculus.
In the Android settings tab, select Oculus.
Close the Project Settings window.
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
At the top left of the window, select Packages: and change the selection to Packages: In Project.
In the list of packages in the left menu, verify that there is a check mark beside the Oculus plugin, indicating that the package is installed.
Note: Installing an XR plugin does not download and import the Meta XR SDKs in to your project. Make sure you download the Meta XR SDKs you need from the Unity Asset Store.
Upgrade to the latest XR plugin version
A few runtime settings may be available on the latest version only.
To upgrade to the latest available plugin version:
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
In the top menu of the Package Manager window, expand the Packages: drop-down, and select Packages: Unity Registry.
From the list of packages in the left menu, select either Oculus XR Plugin or Unity OpenXR Plugin.
In the detailed view, select the Version History tab for actionable items.
Uninstall an XR vendor plugin
Disabling an XR plugin package from the XR Plugin Management interface doesn’t automatically uninstall the plugin. You need to remove the plugin from the Package Manager window.
On the menu, go to Window > Package Manager.
In the top menu of the Package Manager window, expand the Packages: drop-down, and select Packages: In Project.
From the list of packages in the left menu, select either Oculus XR Plugin or OpenXR Plugin.
