<!--
{
  "availability" : [
    "macOS: 15.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSSuggestionItemResponse",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "s:6AppKit24NSSuggestionItemResponseV"
  },
  "title" : "NSSuggestionItemResponse"
}
-->

# NSSuggestionItemResponse

Describes the result of a batch of suggestion items from a search

```
struct NSSuggestionItemResponse<SuggestionItemType>
```

## Topics

### Initializers

[`init()`](/documentation/AppKit/NSSuggestionItemResponse/init())

[`init(itemSections: [NSSuggestionItemResponse<SuggestionItemType>.ItemSection])`](/documentation/AppKit/NSSuggestionItemResponse/init(itemSections:))

[`init(items: [NSSuggestionItemResponse<SuggestionItemType>.Item])`](/documentation/AppKit/NSSuggestionItemResponse/init(items:))

### Instance Properties

[`var itemSections: [NSSuggestionItemResponse<SuggestionItemType>.ItemSection]`](/documentation/AppKit/NSSuggestionItemResponse/itemSections)

The items (organized in sections) representing the results of the search request

[`var phase: NSSuggestionItemResponse<SuggestionItemType>.Phase`](/documentation/AppKit/NSSuggestionItemResponse/phase-swift.property)

Describes the phase of results. In other words, whether this batch of items represents an intermediate set of results–and more are coming, or whether these results are complete/final. Defaults to `.final`.

[`var preferredHighlight: NSSuggestionItemResponse<SuggestionItemType>.Highlight`](/documentation/AppKit/NSSuggestionItemResponse/preferredHighlight)

The preferred response that the control should take when this batch of results comes in (like whether or not to highlight the first selectable item). Defaults to `.automatic`.

### Type Aliases

[`typealias Item`](/documentation/AppKit/NSSuggestionItemResponse/Item)

A suggestion item with the same suggestion item type as the response

[`typealias ItemSection`](/documentation/AppKit/NSSuggestionItemResponse/ItemSection)

A suggestion item section with the same suggestion item type as the response

### Enumerations

[`enum Highlight`](/documentation/AppKit/NSSuggestionItemResponse/Highlight)

Describes the possible ways the highlighted item may be impacted by these results

[`enum Phase`](/documentation/AppKit/NSSuggestionItemResponse/Phase-swift.enum)

Describes the different possible phases of results

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`Equatable`](/documentation/Swift/Equatable)

---

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)