---
title: dismissSearch
framework: swiftui
role: symbol
role_heading: Instance Property
path: swiftui/environmentvalues/dismisssearch
---

# dismissSearch

An action that ends the current search interaction.

## Declaration

```swift
var dismissSearch: DismissSearchAction { get }
```

## Mentioned in

Managing search interface activation

## Discussion

Discussion Use this environment value to get the DismissSearchAction instance for the current Environment. Then call the instance to dismiss the current search interaction. You call the instance directly because it defines a callAsFunction() method that Swift calls when you call the instance. When you dismiss search, SwiftUI: Sets isSearching to false. Clears any text from the search field. Removes focus from the search field. note: Calling this instance has no effect if the user isn’t interacting with a search field. Use this action to dismiss a search operation based on another user interaction. For example, consider a searchable view with a Button that presents more information about the first matching item from a collection: struct ContentView: View {     @State private var searchText = ""

var body: some View {         NavigationStack {             SearchedView(searchText: searchText)                 .searchable(text: $searchText)         }     } }

private struct SearchedView: View {     let searchText: String

let items = ["a", "b", "c"]     var filteredItems: [String] { items.filter { $0 == searchText.lowercased() } }

@State private var isPresented = false     @Environment(\.dismissSearch) private var dismissSearch

var body: some View {         if let item = filteredItems.first {             Button("Details about \(item)") {                 isPresented = true             }             .sheet(isPresented: $isPresented) {                 NavigationStack {                     DetailView(item: item, dismissSearch: dismissSearch)                 }             }         }     } } The button becomes visible only after the user enters search text that produces a match. When the user taps the button, SwiftUI shows a sheet that provides more information about the item, including an Add button for adding the item to a stored list of items: private struct DetailView: View {     var item: String     var dismissSearch: DismissSearchAction

@Environment(\.dismiss) private var dismiss

var body: some View {         Text("Information about \(item).")             .toolbar {                 Button("Add") {                     // Store the item here...

dismiss()                     dismissSearch()                 }             }     } } People can dismiss the sheet by dragging it down, effectively canceling the operation, leaving the in-progress search interaction intact. Alternatively, people can tap the Add button to store the item. Because the person using your app is likely to be done with both the detail view and the search interaction at this point, the button’s closure also uses the dismiss property to dismiss the sheet, and the dismissSearch property to reset the search field. important: Access the action from inside the searched view, as the example above demonstrates, rather than from the searched view’s parent, or another hierarchy, like that of a sheet. SwiftUI sets the value in the environment of the view that you apply the searchable modifier to, and doesn’t propagate the value up the view hierarchy.

## See Also

### Detecting, activating, and dismissing search

- [Managing search interface activation](swiftui/managing-search-interface-activation.md)
- [isSearching](swiftui/environmentvalues/issearching.md)
- [DismissSearchAction](swiftui/dismisssearchaction.md)
- [searchable(text:isPresented:placement:prompt:)](swiftui/view/searchable(text:ispresented:placement:prompt:).md)
- [searchable(text:tokens:isPresented:placement:prompt:token:)](swiftui/view/searchable(text:tokens:ispresented:placement:prompt:token:).md)
- [searchable(text:editableTokens:isPresented:placement:prompt:token:)](swiftui/view/searchable(text:editabletokens:ispresented:placement:prompt:token:).md)
- [searchable(text:tokens:suggestedTokens:isPresented:placement:prompt:token:)](swiftui/view/searchable(text:tokens:suggestedtokens:ispresented:placement:prompt:token:).md)