# dismiss An action that dismisses the current presentation. ``` var dismiss: DismissAction { get } ``` ## Discussion Use this environment value to get the [`DismissAction`](/documentation/SwiftUI/DismissAction) instance for the current [`Environment`](/documentation/SwiftUI/Environment). Then call the instance to perform the dismissal. You call the instance directly because it defines a [`callAsFunction()`](/documentation/SwiftUI/DismissAction/callAsFunction()) method that Swift calls when you call the instance. You can use this action to: - Dismiss a modal presentation, like a sheet or a popover. - Pop the current view from a [`NavigationStack`](/documentation/SwiftUI/NavigationStack). On apps targetting iOS 18 and aligned releases, you also use the dismiss action to pop the implicit stack of a collapsed [`NavigationSplitView`](/documentation/SwiftUI/NavigationSplitView), or clear the equivalent state in an expanded split view. The specific behavior of the action depends on where you call it from. For example, you can create a button that calls the [`DismissAction`](/documentation/SwiftUI/DismissAction) inside a view that acts as a sheet: ``` private struct SheetContents: View { @Environment(\.dismiss) private var dismiss var body: some View { Button("Done") { dismiss() } } } ``` When you present the `SheetContents` view, someone can dismiss the sheet by tapping or clicking the sheet’s button: ``` private struct DetailView: View { @State private var isSheetPresented = false var body: some View { Button("Show Sheet") { isSheetPresented = true } .sheet(isPresented: $isSheetPresented) { SheetContents() } } } ``` Be sure that you define the action in the appropriate environment. For example, don’t reorganize the `DetailView` in the example above so that it creates the `dismiss` property and calls it from the [`sheet(item:onDismiss:content:)`](/documentation/SwiftUI/View/sheet(item:onDismiss:content:)) view modifier’s `content` closure: ``` private struct DetailView: View { @State private var isSheetPresented = false @Environment(\.dismiss) private var dismiss // Applies to DetailView. var body: some View { Button("Show Sheet") { isSheetPresented = true } .sheet(isPresented: $isSheetPresented) { Button("Done") { dismiss() // Fails to dismiss the sheet. } } } } ``` If you do this, the sheet fails to dismiss because the action applies to the environment where you declared it, which is that of the detail view, rather than the sheet. In fact, in macOS and iPadOS, if the `DetailView` is the root view of a window, the dismiss action closes the window instead. The dismiss action has no effect on a view that isn’t currently presented. If you need to query whether SwiftUI is currently presenting a view, read the [`isPresented`](/documentation/SwiftUI/EnvironmentValues/isPresented) environment value. > Note: While the dismiss action can be used to a close window that you > create with ``doc://com.apple.SwiftUI/documentation/SwiftUI/WindowGroup`` or ``doc://com.apple.SwiftUI/documentation/SwiftUI/Window``, prefer > ``doc://com.apple.SwiftUI/documentation/SwiftUI/DismissWindowAction`` for that use case instead. --- Copyright © 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)