<!--
{
  "availability" : [
    "visionOS: 2.0.0 -",
    "Xcode: 16.0.0 -"
  ],
  "documentType" : "article",
  "framework" : "visionOS",
  "identifier" : "/documentation/visionOS/creating-a-new-swiftui-window-in-visionos",
  "metadataVersion" : "0.1.0",
  "role" : "sampleCode",
  "title" : "Creating SwiftUI windows in visionOS"
}
-->

# Creating SwiftUI windows in visionOS

Display and manage multiple SwiftUI windows in your visionOS app.

## Overview

This sample code project demonstrates how to open a new SwiftUI view and a separate window group to manage multiple windows, assigning a unique `id` to each newly created window. In the sample, the app displays a SwiftUI window with a <doc://com.apple.documentation/documentation/SwiftUI/Button> that a person can tap to open a new window view, as the following image illustrates:

![A screenshot of a visionOS app in Simulator displaying one center window, with a button labeled 'Open a new window', and two smaller translucent windows on either side labeled 'New window number 0' and 'New window number 1'.](images/com.apple.visionOS/sample-new-window-1-main-view.png)

### Create a variable to track window IDs

To manage multiple windows for an app, the app uses the <doc://com.apple.documentation/documentation/Swift/Identifiable> protocol to establish an ID value for each new window view.

```swift
import SwiftUI

struct NewWindowID: Identifiable {
    /// The unique identifier for the window.
    var id: Int
}
```

### Add a button for creating windows

The `OpenNewWindow` view creates and displays a SwiftUI button. When a person taps the button, a new SwiftUI window appears.

```swift
import SwiftUI

struct OpenWindowView: View {
    /// The `id` value that the main view uses to identify the SwiftUI window.
    @State var nextWindowID = NewWindowID(id: 1)

    /// The environment value for getting an `OpenWindowAction` instance.
    @Environment(\.openWindow) private var openWindow

    var body: some View {
        // Create a button in the center of the window that
        // launches a new SwiftUI window.
        Button("Open a new window") {
            // Open a new window with the assigned ID.
            openWindow(value: nextWindowID.id)

            // Increment the `id` value of the `nextWindowID` by 1.
            nextWindowID.id += 1
        }
    }
}
```

The <doc://com.apple.documentation/documentation/SwiftUI/EnvironmentValues/openWindow> instance property invokes a new window view in an app’s environment.

### Create a view for the new window

The `NewWindow` view displays the window’s `id` value in a <doc://com.apple.documentation/documentation/SwiftUI/Text> instance.

```swift
import SwiftUI

struct NewWindow: View {
    /// Acts as the main identifier for the new view.
    let id: Int
    
    var body: some View {
        // Create a text view that displays
        // the window's `id` value.
        Text("New window number \(id)")
    }
}
```

### Add new windows to a window group

The `EntryPoint` provides a specific <doc://com.apple.documentation/documentation/SwiftUI/WindowGroup> to create a window view and add the new window to the app’s main view.

```swift
import SwiftUI

@main
struct EntryPoint: App {
    var body: some Scene {
        WindowGroup {
            MainView()
        }
        
        /// A `WindowGroup` for each newly created window in the app's main view.
        WindowGroup("New Window", for: NewWindowID.ID.self) { $id in
            NewWindow(id: id ?? 1)
        }
    }
}
```

## See Also

#### Related samples

[Creating 3D models as movable windows](/documentation/visionOS/creating-a-volumetric-window-in-visionos)

Display 3D content with a volumetric window that people can move.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)