---
title: dismissImmersiveSpace
framework: swiftui
role: symbol
role_heading: Instance Property
path: swiftui/environmentvalues/dismissimmersivespace
---

# dismissImmersiveSpace

An immersive space dismissal action stored in a view’s environment.

## Declaration

```swift
var dismissImmersiveSpace: DismissImmersiveSpaceAction { get }
```

## Discussion

Discussion Use this environment value to get a DismissImmersiveSpaceAction instance for a given Environment. Then call the instance to dismiss a space. You call the instance directly because it defines a callAsFunction() method that Swift calls when you call the instance. On macOS, this may be used to dismiss a remote immersive space declared with RemoteImmersiveSpace. For example, you can define a button that dismisses an immersive space: @main struct MyApp: App {     var body: some Scene {         WindowGroup {             DismissImmersiveSpaceButton()         }         ImmersiveSpace(id: "solarSystem") {             SolarSystemView()         }     } }

struct DismissImmersiveSpaceButton: View {     @Environment(\.dismissImmersiveSpace) private var dismissImmersiveSpace

var body: some View {         Button("Dismiss") {             Task {                 await dismissImmersiveSpace()             }         }     } } The asynchronous call returns after the system finishes dismissing the space. Unlike the call to openImmersiveSpace that you use to open the space — which requires an identifier, a value, or both to specify which space to open — the dismiss action requires no parameters because there can be only one immersive space open at a time. The call closes the space that is currently open, if any.

## See Also

### Closing the immersive space

- [DismissImmersiveSpaceAction](swiftui/dismissimmersivespaceaction.md)