# Suggest Modes in .NET MAUI AutoComplete

AutoComplete exposes three different modes for providing suggestions:

* `Suggest`—Provides a drop-down list of options for you to pick from;
* `Append`—Provides an inline display of the first suggestion;
* `SuggestAppend`—Combines the functionality of the two options above, shows a drop-down with suggestions and at the same time selects the first one from the list.

To choose any of those modes, use the `SuggestMode` property of the control. The default `SuggestMode` is `Suggest`.

## Example

Here is an example how the AutoComplete Suggest Mode functionality works:

Create the needed business objects, for example type Client with the following properties:

```C#
public class Client
{
    public Client() { }

    public Client(string name, string imageSource)
    {
        this.Name = name;
        this.ImageSource = imageSource;
    }

    public Client(string name, string email, string imageSource)
    {
        this.Name = name;
        this.Email = email;
        this.ImageSource = imageSource;
    }

    public string Name { get; set; }
    public string Email { get; set; }
    public string ImageSource { get; set; }
}
```

Create a ViewModel with a collection of Client objects:

```C#
public class ClientsViewModel
{
    public ClientsViewModel()
    {
        this.Source = new ObservableCollection<Client>()
        {
            new Client("Freda Curtis", "fcurtis@mail.com", "available.png"),
            new Client("Jeffery Francis", "jfrancis@mail.com", "away.png"),
            new Client("Eva Lawson", "elawson@mail.com", "available.png"),
            new Client("Emmett Santos", "esantos@mail.com", "busy.png"),
            new Client("Theresa Bryan", "tbryan@mail.com", "available.png"),
            new Client("Jenny Fuller", "jfuller@mail.com", "busy.png"),
            new Client("Terrell Norris", "tnorris@mail.com", "away.png"),
            new Client("Eric Wheeler", "ewheeler@mail.com", "away.png"),
            new Client("Nida Carty", "ncarty@mail.com", "away.png"),
            new Client("Niki Samaniego", "nsamaniego@mail.com", "busy.png")
        };
    }

    public ObservableCollection<Client> Source { get; set; }
}
```

**Example when `SuggestMode="Suggest"`**:

```XAML
<telerik:RadAutoComplete x:Name="autoCompleteSuggest"
                         SuggestMode="Suggest"
                         ItemsSource="{Binding Source}"
                         TextSearchPath="Name"
                         Placeholder="Search"
                         SuggestionViewMaxHeight="150"/>
```

Here is the result when `SuggestMode` is `Suggest`:

![Telerik UI for .NET MAUI AutoComplete Suggest mode showing a dropdown of matching client names](https://www.telerik.com/maui-ui/documentation/assets/c77b9936d582181856e20f4b66cc65bf/autocomplete-suggest-mode-suggest.png "AutoComplete Suggest")

**Example when `SuggestMode="Append"`**:

```XAML
<telerik:RadAutoComplete x:Name="autoCompleteAppend"
                         SuggestMode="Append"
                         ItemsSource="{Binding Source}"
                         TextSearchPath="Name"
                         Placeholder="Search"
                         SuggestionViewMaxHeight="150"/>
```

And the final result:

![Telerik UI for .NET MAUI AutoComplete Append mode completing the input with the first matching client name](https://www.telerik.com/maui-ui/documentation/assets/1f7afae217c39a71cffc611722a51c96/autocomplete-suggest-mode-append.png "AutoComplete Append")

**Example when `SuggestMode="SuggestAppend"`**:

```XAML
<telerik:RadAutoComplete x:Name="autoCompleteSuggestAppend"
                         SuggestMode="SuggestAppend"
                         ItemsSource="{Binding Source}"
                         TextSearchPath="Name"
                         Placeholder="Search"
                         SuggestionViewMaxHeight="100"/>
```

Here is the result:

![Telerik UI for .NET MAUI AutoComplete SuggestAppend mode showing the completed first match and suggestion dropdown](https://www.telerik.com/maui-ui/documentation/assets/a8d827756bec566e4471cae494b71ada/autocomplete-suggest-mode-suggestappend.png "AutoComplete SuggestAppend")

> important For AutoComplete Suggest Mode example refer the [SDKBrowser Demo application](https://www.telerik.com/maui-ui/documentation/demos-and-sample-apps/sdkbrowser-app).

## See Also

* [Display Text](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/display-text)
* [Tokens Support](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/tokens-support)
* [Remote Search](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/remote-search)
* [Filtering](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/filtering)
* [Events](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/events)
* [Methods](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/methods)
* [Templates](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/templates/overview)
* [Styling](https://www.telerik.com/maui-ui/documentation/controls/autocomplete/styling)