# Suggesting search terms Provide suggestions to people searching for content in your app. ## Discussion You can suggest query text during a search operation by providing a collection of search suggestion views. Because suggestion views are not limited to plain text, you must also provide the search string that each suggestion view represents. You can also provide suggestions for tokens, if your search interface includes them. SwiftUI presents the suggestions in a list below the search field.  For both text and tokens, you manage the list of suggestions, so you have complete flexibility to decide what to suggest. For example, you can: - Offer a static list of suggestions. - Remember previous searches and offer the most recent or most common ones. - Update the list of suggestions in real time based on the current search text. - Employ some combination of these and other strategies, possibly changing over time. ### Suggest search text Suggest search text by providing a collection of views to the [`searchSuggestions(_:)`](/documentation/SwiftUI/View/searchSuggestions(_:)) view modifier. This modifier applies to the [`searchable(text:placement:prompt:)`](/documentation/SwiftUI/View/searchable(text:placement:prompt:)) modifier that appears before it. When someone activates the search interface, it presents the suggestion views as a list of choices below the query string. Associate a string with each suggestion view by adding the [`searchCompletion(_:)`](/documentation/SwiftUI/View/searchCompletion(_:)) modifier to the view inside the search suggestions closure. For example, you can include emoji with fruit types that you suggest as possible products to search for, and provide the corresponding search string as a search completion in each case: ``` ProductList(departmentId: departmentId, productId: $productId) .searchable(text: $model.searchText) .searchSuggestions { Text("🍎 Apple").searchCompletion("apple") Text("🍐 Pear").searchCompletion("pear") Text("🍌 Banana").searchCompletion("banana") } ``` When someone chooses a suggestion, SwiftUI replaces the text in the search field with the search completion string. In the above example, choosing “🍐 Pear” puts the text “pear” in the search query.  If you omit the search completion modifier for a particular suggestion view, SwiftUI displays the view, but the view doesn’t react to taps or clicks. However, you can group the views with [`Section`](/documentation/SwiftUI/Section) containers that have headers, enabling you to distinguish different kinds of suggestions, like recent searches and common search terms. > Important: In tvOS, searchable modifiers only support suggestion views > of type ``doc://com.apple.SwiftUI/documentation/SwiftUI/Text``, like in the above example. Other platforms can use > arbitrary views for the suggestions, including custom views. Certain events or actions, like when someone moves a macOS window, might dismiss the suggestion list. ### Suggest tokens You can also suggest tokens for the search field. In this case, associate a suggestion view with a token using the version of the [`searchCompletion(_:)`](/documentation/SwiftUI/View/searchCompletion(_:)) modifier that takes tokens as input: ``` ProductList(departmentId: departmentId, productId: $productId) .searchable(text: $model.searchText, tokens: $model.tokens) { token in switch token { case .apple: Text("Apple") case .pear: Text("Pear") case .banana: Text("Banana") } } .searchSuggestions { Text("Apple").searchCompletion(FruitToken.apple) Text("Pear").searchCompletion(FruitToken.pear) Text("Banana").searchCompletion(FruitToken.banana) } ``` You can use any type that conforms to the protocol as a token. For more information about using tokens in the search query, see [Performing a search operation](/documentation/SwiftUI/Performing-a-search-operation). ### Simplify token suggestions As a convenience when you have a collection of suggestions that exactly matches the list of tokens, you can create a collection of possible tokens to suggest. For example, you can add a published `suggestions` property to your model that contains all the possible tokens: ``` @Published var suggestions: [FruitToken] = FruitToken.allCases ``` Then you can provide this array to one of the searchable modifiers that takes a `suggestedTokens` input parameter, like [`searchable(text:tokens:suggestedTokens:placement:prompt:token:)`](/documentation/SwiftUI/View/searchable(text:tokens:suggestedTokens:placement:prompt:token:)). SwiftUI uses this to generate the suggestions automatically: ``` ProductList(departmentId: departmentId, productId: $productId) .searchable( text: $model.searchText, tokens: $model.tokens, suggestedTokens: $model.suggestions ) { token in switch token { case .apple: Text("Apple") case .pear: Text("Pear") case .banana: Text("Banana") } } ``` In this version of the searchable modifier, SwiftUI uses one content builder to describe the appearance of the tokens in both the search field and the suggestions container. ### Update suggestions dynamically You can update the suggestions that you provide as conditions change. For example, you can specify an array of `suggestedSearches` that you store in your app’s model: ``` ProductList(departmentId: departmentId, productId: $productId) .searchable(text: $model.searchText) .searchSuggestions { ForEach(model.suggestedSearches) { suggestion in Label(suggestion.title, image: suggestion.image) .searchCompletion(suggestion.text) } } ``` If `suggestedSearches` begins as an empty array, the interface doesn’t display any suggestions to start. You can then update the array as conditions change, like when you want to include previous searches. --- 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)