Can we use pushWindow with volumes?

As of January 2026 and visionOS 26.2, we cannot use pushWindow with Volumes.

From October 2025: During this visionOS 2 beta season, using pushWindow with volumes worked, but now it seems this is not supported. If we try to call pushWindow from an existing volume, the new volume will not be placed relative to the existing volume and we will see this error:

PushWindowAction requires the replaced window to be a WindowGroup or DocumentGroup

PushWindowAction requires the replaced window to be a WindowGroup or DocumentGroup

I found this discussion on the Apple Developer Forum

pushWindow isn’t supported for volumes

I will update this post in the future if this changes.

Update on Jan 15, 2026, testing with visionOS 26.2. This is still unsupported for volumes. When trying it today, we saw this error in the console.

PushWindowAction requires the replaced window to be a DocumentGroup or a WindowGroup with a window style of PlainWindowStyle or DefaultWindowStyle

PushWindowAction requires the replaced window to be a DocumentGroup or a WindowGroup with a window style of PlainWindowStyle or DefaultWindowStyle

Sample code is available in Garden10 in the Step Into Example Projects repo.

Download the Xcode project with this and many more examples from Step Into Vision.

Some examples are provided as standalone Xcode projects. You can find those here.