Test multiple windows
Updated: Sep 30, 2026
Meta Spatial Simulator runs several app panels together. Use it to check how your app behaves when it shares the screen, moves to the background, and comes back.
Every app panel has a control bar beneath it. The bar is collapsed into a small pill until you hover it. Expanded, it shows:
- Back, which navigates back inside the app
- The app title
- Close app, which closes the app
Settings → Go Home minimizes the app in the foreground and returns you to the home screen. The app keeps running in the background.
Window Manager is the overview of everything running. Open it three ways:
- Settings → Open Window Manager
- The app-switch key on your keyboard
- Show all, on the pill that appears when apps are running in the background
The pill reads +N background apps and counts what is running out of view.
In the overview you get a grid of running apps, where you can:
- Select a tile to bring that app forward
- Hover a tile to enlarge it
- Close a single app with the X in the corner of its tile
- Close everything with Close all
How many panels stay visible
The simulator shows one foreground app plus up to three background panels. Beyond that, apps keep running and stay tracked, but their panels stay hidden until you bring them forward from Window Manager. This ceiling is a limit of the simulator’s screen space, not the app limit on a headset.
The background panel stack and child-window layout are different systems. A top-level app panel can move into the background stack. A child window stays in its parent’s group, uses parent-relative placement, and is destroyed when its parent is.
An anchor joins a point on the child to a point on the parent. To place a child directly to the right, attach the child’s start edge to the parent’s end edge. Attaching the child’s center to the parent’s end edge intentionally overlaps half of the child before any size constraint is applied.
The parent and child share a maximum combined footprint of 1600 × 960 dp in both Meta Spatial Simulator and the headset shell. If an anchor or offset would exceed that footprint, the system moves the child toward the parent until the group fits. The child can therefore overlap the parent after the parent is resized, even if the original placement was edge to edge.
WindowLifecycle.Active means that the child is placed and rendering. It does not mean that the requested anchor and offset were applied without adjustment. A constrained child remains active, and Meta Spatial Simulator writes a warning with the requested and resolved positions.
The simulator renders 2D panels only. Launching a fully immersive app raises a dialog reading Immersive apps aren’t supported yet, and the app does not start. Test immersive builds on a headset or the Meta XR Simulator instead.
Drive windows from the command line
Meta VR CLI lists windows and reports which one has focus, and drives the UI for automated testing:
metavr window list
metavr window focus