---
title: Window
framework: swiftui
role: symbol
role_heading: Structure
path: swiftui/window
---

# Window

A scene that presents its content in a single, unique window.

## Declaration

```swift
nonisolated struct Window<Content> where Content : View
```

## Overview

Overview Use a Window scene to augment the main interface of your app with a window that gives people access to supplemental functionality. For example, you can create a secondary window in a mail reader app that enables people to view the status of their account connections:  @main  struct Mail: App {      var body: some Scene {          WindowGroup {              MailViewer()          }          Window("Connection Doctor", id: "connection-doctor") {              ConnectionDoctor()          }      }  } Provide a title as the first argument to the window’s intializer. The system uses the title to identify the window to people using your app in the window’s title bar or in the list of available singleton windows that the Windows menu displays automatically. note: You can override the title in the window’s title bar by adding one of the navigationTitle(_:) view modifiers to the window’s content. This enables you to dynamically update the title bar. Open a window programmatically People open the window by selecting it in the Windows menu, but you can also open the window programmatically using the openWindow action that you read from the environment. Use the id parameter that you initialize the window with to indicate which window to open. For example, you can create a button to open the window from the previous example: struct OpenConnectionDoctorButton: View {     @Environment(\.openWindow) private var openWindow

var body: some View {         Button("Connection doctor") {             openWindow(id: "connection-doctor") // Match the window's identifier.         }     } } If the window is already open when you call this action, the action brings the open window to the front. Be sure to use unique identifiers across all of the Window and WindowGroup instances that you define. Dismiss a window programmatically The system provides people with controls to close windows, but you can also close a window programmatically using the dismiss action from within the window’s view hierarchy. For example, you can include a button in the connection doctor view that dismisses the view: struct ConnectionDoctor: View {     @Environment(\.dismiss) private var dismiss

var body: some View {         VStack {             // ...

Button("Dismiss") {                 dismiss()             }         }     } } The dismiss action doesn’t close the window if you call it from a modal — like a sheet or a popover — that you present from within the window. In that case, the action dismisses the modal presentation instead. Use a window as the main scene You can use a window as the main scene of your app when multi-window functionality isn’t appropriate. For example, it might not make sense to display more than one window for a video call app that relies on a hardware resource, like a camera: @main struct VideoCall: App {     var body: some Scene {         Window("VideoCall", id: "main") {             CameraView()         }     } } If your app uses a single window as its primary scene, the app quits when the window closes. This behavior differs from an app that uses a WindowGroup as its primary scene, where the app continues to run even after closing all of its windows. note: In most cases it’s best to use a WindowGroup to represent the main scene of your app. A window group provides multi-window functionality on platforms that support it, like iPadOS and macOS, and makes it easier to share code across platforms.

## Topics

### Creating a window

- [init(_:id:content:)](swiftui/window/init(_:id:content:).md)

## Relationships

### Conforms To

- [Scene](swiftui/scene.md)

## See Also

### Creating windows

- [WindowGroup](swiftui/windowgroup.md)
- [UtilityWindow](swiftui/utilitywindow.md)
- [WindowStyle](swiftui/windowstyle.md)
- [windowStyle(_:)](swiftui/scene/windowstyle(_:).md)