Develop

Meta XR performance settings in Unreal Engine

Updated: Apr 17, 2026
The Meta XR Project Setup Tool provides a streamlined way to apply recommended performance settings for your Meta Quest projects. When you apply a setting, it is written immediately to your project configuration. Some settings require an editor restart; the tool prompts you when this is the case. When you select Ignore, the setting is acknowledged without modifying any project configuration. Ignored rules are stored per-user and can be restored.
Note: This tool is intended to simplify performance settings adjustment. If you need a more comprehensive way to manage your project settings, use the standard Project Settings screens.

Prerequisites

Before using the Meta XR Project Setup Tool, you need to enable the Meta XR plugin.
To enable the Meta XR plugin:
  1. From the Edit menu, click Plugins.
  2. In the ALL PLUGINS window, under INSTALLED, open the Virtual Reality section.
  3. Select the Enable checkbox for the Meta XR plugin.
  4. Restart Unreal Engine.
Note: The Meta XR plugin must be enabled separately for each project.
If the Meta XR plugin is not displayed, install it in Unreal Engine separately. To do this, see Installing the Meta XR Plugin.

Launch the Meta XR Project Setup Tool

  1. From the Edit menu, click Project Settings.
  2. Under Plugins, select Meta XR.
  3. Click Launch Meta XR Project Setup Tool.
    Launch Meta XR Project Setup Tool

Modify performance settings

When the Meta XR Project Setup Tool opens, use the platform filter dropdown to select your target platform. The following options are available:
  • All Meta Quest (default): Shows settings for Quest 2, Quest 3, and Quest Pro combined.
  • MetaLink: Shows settings for Meta Quest Link and Air Link tethered PC sessions.
  • Quest 3: Shows Quest 3-specific settings.
  • Quest Pro: Shows Quest Pro-specific settings.
  • Quest 2: Shows Quest 2-specific settings.
Platform filter dropdown
The following options are displayed for PC-VR apps:
PC-VR app options
SettingWhat it does
Enable Instanced Stereo
Reduces draw calls using multi-view rendering. Requires an editor restart.
Enable PC Forward Shading
Enables forward shading for PC targets. Requires an editor restart.
The following options are displayed for Meta Quest apps:
Meta Quest app options
SettingWhat it does
Use Vulkan Rendering Backend
Sets Vulkan as the rendering backend.
Use Half Precision Float
Enables half-precision floating point. Requires an editor restart.
Enable MSAA
Enables 4x MSAA antialiasing.
Enable Occlusion Culling
Enables hardware occlusion culling.
Enable Dynamic Foveation
Enables dynamic foveated rendering.
Disable Post Processing
Disables mobile post-processing, including Mobile HDR. Requires an editor restart.
Enable Mobile Multi-View
Enables mobile multi-view stereo rendering. Requires an editor restart.
Disable Lens Flare
Disables lens flare post-processing.
Enable Static Lighting
Enables static lighting. Requires an editor restart.
Enable Forward Shading
Enables forward shading for Quest 2. Requires an editor restart.
Disable Ambient Occlusion
Disables mobile ambient occlusion. Available in UE 5.6 and earlier. Requires an editor restart.
Nav Logo
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
English (US)
© 2026 Meta