---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/suggest.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/suggest.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/en/llms.txt

# suggest

{% include [include](../../../_includes/2.1/terms/index-e50a13eaa8b4.md) %}

Static function.

Processes requests for search suggestions. Returns a promise object that is either rejected with an error, or confirmed by an array of objects in the format { displayName: "Mitishi, Moscow region", value: "Russia, Moscow region, Mitishi " }. The displayName field represents the toponym in a user-friendly way, and the value field represents the value which should be inserted into the search field after the user selects the suggestion.

**Returns** a Promise object.

```javascript
{ vow.Promise } suggest(request[, options])
```

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`request`](#param-request)[*](*star) | — | Type: String

Request string. ||
|| [`options`](#param-options) | — | Type: Object

Options. ||
|| [`options.boundedBy`](#param-options.boundedBy) | — | Type: Number[][]

A rectangular area on the map, where the object being searched for is presumably located. Must be set as an array, such as [[30, 40], [50, 50]]. ||
|| [`options.provider`](#param-options.provider) | 'yandex#map' | Type: [ISuggestProvider](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ISuggestProvider.md)\|String

Search suggestion provider. You can use the 'yandex#map' built-in search suggestion provider for map objects, or specify your own. ||
|| [`options.results`](#param-options.results) | — | Type: Number

Maximum number of results to be returned. ||
|#

\* Mandatory parameter/option.

**Example:**

```javascript
ymaps.suggest('myt').then(function (items) {
    // items - Array of search suggestions.
});
```

[*star]: Mandatory parameter/option.