# Attaching a Suggester – a component with suggestions

*Suggester* This is a special kind of external data source used mainly for text fields. Its purpose is to suggest or automatically correct the value entered by the user, according to a specific algorithm. The suggester works on the server side – when the user enters data and leaves the field, the suggester service can, for example, modify that value (enforcing a specific format, range, etc.) or suggest another one.

**Step-by-step configuration:**

1. **Component selection:** You need to select a component of type **Text field** (TextField), for which the suggestion or correction mechanism is to be enabled.
2. **Selecting the suggester:** In the Properties panel, go to the Interactions section. In the field **External data source** you need to click **Choose service**, and then select the appropriate **Suggester**from the list of available sources. After connecting it, the suggester identifier should appear in the field (e.g. its name).
3. **Automatic value update:** In the Other properties section of the text field, check the option **Automatic value update** (autoServerUpdate). This setting causes the value to be sent to the server after each end of editing of the field (e.g. after leaving the field or losing focus). Thanks to this, the suggester will receive the value entered by the user and will be able to return a possibly modified one. If the autoServerUpdate option is not enabled, the suggester will not work – the change in the field value will not be recorded on the server side.
4. **Finishing the configuration:** After finishing the configuration, save the changes. From that moment on, the text field will be linked to the Suggester. When the user enters a value and finishes editing (e.g. moves to the next field), the suggester mechanism will process the entered value. If it requires correction, the system will automatically replace it with the suggested one (e.g. increase it to the minimum allowed value). The suggester can also display messages to the user – for example, information about the correction made.
5. **Customizing messages:** If the suggester has default messages (e.g. in English), it is worth translating them into Polish. To do this, go to the **Translations** tab in the application editor and find the message keys associated with the given **Suggester**. Then add the appropriate translations into Polish.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Ffcri0AiiC4sYasi4hx2Q%2Fimage.png?alt=media&#x26;token=0603409b-040e-486b-bb4a-15d1b0956382" alt="" width="563"><figcaption><p align="center"><em><strong>Figure 1.</strong> Example of a connected suggester in Eximee Designer</em></p></figcaption></figure>

{% hint style="info" %}
Demo application: demoSuggester
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/zasilanie-wartosciami-z-zewnetrznych-zrodel/podpiecie-suggestera-komponent-z-podpowiedziami.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
