Unity Troubleshooting

OVerview

This page is a shared troubleshooting log for common Unity technical errors. Each entry follows a Problem → Cause → Solution format. If you've run into an issue that isn't listed here, feel free to add it! The goal is to build a collective reference that saves the next person time.

#2 World Space Canvas not visible in headset

Problem

A Canvas is visible in the Scene view but doesn't appear when wearing the headset

Cause

Canvas Render Mode is set to Screen Space - Overlay instead of World Space. Screen Space canvases render in 2D on the screen and are not visible in XR. Or Canvas scale is too large. World Space Canvas defaults to pixel dimensions, at default scale (1, 1, 1) it appears enormous and may be behind or far outside the camera view.

Solution

Select the Canvas → set Render Mode to World Space - Set Scale to 0.001, 0.001, 0.001 - Position it in front of the camera (e.g. Z: 0.5–1.0m)

Contributed by Ellie Na (2026)

#3 Passthrough appears black instead of showing real-world view

Problem

Passthrough mode is enabled, but the headset only shows a black background instead of the real-world camera feed.

Cause

The OVRPassthroughLayer was either missing, disabled, or configured with the wrong placement setting. In some cases, the Main Camera background was not set correctly.

Solution

• Add OVRPassthroughLayer to the OVRCameraRig

• Set Placement to Underlay

• Set Main Camera background to Solid Color

• Change the background color to pure black

• Ensure Passthrough Capability is enabled in Project Settings

• Rebuild and redeploy to Quest

Contributed by Ellie Na (2026)