---
title: foundSuggestionsHandler
framework: corespotlight
role: symbol
role_heading: Instance Property
path: corespotlight/csuserquery/foundsuggestionshandler
---

# foundSuggestionsHandler

The block to execute when the query delivers a new batch of suggested items.

## Declaration

```swift
var foundSuggestionsHandler: (([CSSuggestion]) -> Void)? { get set }
```

## Mentioned in

Building a search interface for your app

## Discussion

Discussion Specify a value for this property only if you start your query with the start() method. While the query runs, the query object executes the provided closure one or more times to deliver suggested completions for the current search term. Use your handler to retrieve the suggested completions and update your app’s search interface. The query object stops delivering suggested items when it runs out of suggestions or reaches the maximum number found in the maxSuggestionCount property of the query configuration parameters. If you start the query by accessing the responses property, the query object doesn’t execute the block in this property.

## See Also

### Executing the query with handler blocks

- [start()](corespotlight/csuserquery/start().md)
- [cancel()](corespotlight/csuserquery/cancel().md)
- [foundSuggestionCount](corespotlight/csuserquery/foundsuggestioncount.md)