<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UISearchSuggestion",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(pl)UISearchSuggestion"
  },
  "title" : "UISearchSuggestion"
}
-->

# UISearchSuggestion

A set of attributes that a selectable search suggestion must provide.

```
@MainActor protocol UISearchSuggestion : NSObjectProtocol
```

## Overview

Provide common or predicted search queries to save the user the time of typing their entire query in a [`UISearchController`](/documentation/UIKit/UISearchController) field. [`UISearchSuggestionItem`](/documentation/UIKit/UISearchSuggestionItem) provides a simple implementation of this protocol. You may also define and use your own type that conforms to [`UISearchSuggestion`](/documentation/UIKit/UISearchSuggestion).

## Topics

### Describing a search suggestion

[`localizedSuggestion`](/documentation/UIKit/UISearchSuggestion/localizedSuggestion)

A label for the suggestion, usually the search term the suggestion represents.

[`localizedDescription`](/documentation/UIKit/UISearchSuggestion/localizedDescription)

A description of the suggestion.

[`localizedAttributedSuggestion`](/documentation/UIKit/UISearchSuggestion/localizedAttributedSuggestion)

An attributed label for the suggestion, usually the search term the suggestion represents.

[`iconImage`](/documentation/UIKit/UISearchSuggestion/iconImage)

An image for display on the suggestion.

[`representedObject`](/documentation/UIKit/UISearchSuggestion/representedObject)

An object for tracking supplementary information about the search suggestion.


---

Copyright &copy; 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)