# searchSuggestions A list of suggestions to offer as shortcuts below the search field. ``` var searchSuggestions: [any UISearchSuggestion]? { get set } ``` ## Discussion Provide search suggestions to help people complete their query quickly. Update the suggestions as a person types by implementing [`updateSearchResults(for:)`](/documentation/UIKit/UISearchResultsUpdating/updateSearchResults(for:)). The presentation of the search suggestions varies according to the platform and [`searchBarPlacement`](/documentation/UIKit/UINavigationItem/searchBarPlacement-swift.property): - In tvOS, the suggestions appear in a list below the keyboard. - In iOS, the suggestions appear in a menu below the search field when the search bar placement is [`inline`](/documentation/UIKit/UINavigationItem/SearchBarPlacement-swift.enum/inline), and in a list that overlays the [`searchResultsController`](/documentation/UIKit/UISearchController/searchResultsController) when the search bar placement is [`UINavigationItem.SearchBarPlacement.stacked`](/documentation/UIKit/UINavigationItem/SearchBarPlacement-swift.enum/stacked). To prevent the search controller from creating and presenting a search suggestions view controller when the [`searchBarPlacement`](/documentation/UIKit/UISearchController/searchBarPlacement) is [`UINavigationItem.SearchBarPlacement.stacked`](/documentation/UIKit/UINavigationItem/SearchBarPlacement-swift.enum/stacked), set [`ignoresSearchSuggestionsForSearchBarPlacementStacked`](/documentation/UIKit/UISearchController/ignoresSearchSuggestionsForSearchBarPlacementStacked) to when you create the search controller. When you assign new suggestions to this property, the suggestions onscreen refresh automatically. When a person selects a suggestion, the system sets this property to `nil` and dismisses the search suggestions menu. Implement [`updateSearchResults(for:selecting:)`](/documentation/UIKit/UISearchResultsUpdating/updateSearchResults(for:selecting:)) to execute any necessary updates when a person selects a suggestion. > Note: > In tvOS, when a person selects a search suggestion, the search controller automatically updates the search bar’s ``doc://com.apple.uikit/documentation/UIKit/UISearchBar/text`` according to the value of ``doc://com.apple.uikit/documentation/UIKit/UISearchSuggestion/localizedSuggestion``. If the search suggestions menu dismisses for other reasons, such as a person tapping outside the search bar, [`searchSuggestions`](/documentation/UIKit/UISearchController/searchSuggestions) doesn’t reset to `nil` immediately. The system sets [`searchSuggestions`](/documentation/UIKit/UISearchController/searchSuggestions) to `nil` only when a person interacts with search directly — for example, by typing in the search field, canceling search, or changing the search scope using the search bar’s scope bar. To dismiss the menu manually, set this property to `nil` or `[]`. --- 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)