> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md).

# Satisfaction surveys

Learn how to configure satisfaction surveys to collect feedback from your customers.

Satisfaction surveys allow you to collect feedback from your customers after an experience, measure satisfaction across various criteria (NPS, CSAT, etc.), and automate delivery through your communication channels (email, SMS, WhatsApp, QR code).

{% hint style="info" icon="shield-check" %}
**ACCESS RIGHTS**

To edit the surveys in your Fullwhere workspace, you must be a supervisor member with Administrator permissions.
{% endhint %}

## Access your surveys <a href="#h_ab4fa14d8c" id="h_ab4fa14d8c"></a>

In the navigation menu, go to [Surveys](https://app.fullwhere.com/forms/survey).\
There you’ll find a list of all existing surveys, their status (Active / Inactive), their creator, and their creation date.

You can:

* Create a new survey using the `+ Créer une enquête` ;
* Search for a survey using the search bar;
* Activate / deactivate a survey using the *Activate / Deactivate* ;
* Access a survey’s settings by clicking its name.

***

## Create a new survey <a href="#h_79555e24c7" id="h_79555e24c7"></a>

Click + Create a survey, then enter the basic information in the right-hand side panel:

* Survey name: an internal name that is not visible to your customers.
* Description (optional): useful for specifying the survey’s purpose or the period during which it will be used.
* Delivery channels: select the channels through which the survey will be distributed (Email, SMS, WhatsApp).
* Survey language: specify the language in which the survey will be written.\
  → You can enable automatic translation to adapt the survey to the customer’s language. For optimal translation, it’s important to set the survey language to the language in which you wrote it.
* Public access: makes the survey link accessible without authentication (useful for sharing direct links or QR codes).
* Survey targets: define the brands and/or locations covered by the survey, for which you want to send surveys or generate a specific survey link.

These settings can be changed at any time.

***

## Navigating the different menus <a href="#h_9940d5bccb" id="h_9940d5bccb"></a>

The navigation menu in the bottom-right corner lets you configure the different sections of your satisfaction survey.

The Landing Pages section:

![](https://downloads.intercomcdn.com/i/o/a50210op/1916553642/17e48ff9a3984a6c3d4830a3a41e/image.png?expires=1773057600\&signature=00eaaeb36fbbf16b72dd135489c7f0aff122e70e01a17f7db7154cf857ddf30a\&req=dSkmEMx7nodbW%2FMW3nq%2Bga%2BFhwrDtfb7E%2F52Wsl%2FhsBCjj%2F0RN%2FATj0ZUpcW%0AsXf0yu350RKZHdHxmVr8JjOUe7M%3D%0A)

This section lets you configure your survey’s general settings and its various landing pages:

* the [survey page](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md#h_fd6c17647b)
* the [thank-you page](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_e7a846fde6)
* the [redirect page](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_d2a178d4d6)

The Delivery Methods section:

![](https://downloads.intercomcdn.com/i/o/a50210op/1916553929/3b70048a4185a6590126067c7dbf/image.png?expires=1773057600\&signature=1de5a3071f908abc4e5cc11d898c12c98f5cc2441d9a1f1a84c6d564e8ef61d3\&req=dSkmEMx7nohdUPMW3nq%2BgR%2BX4QuW%2FUPA4cccTFIu69TIC8oCd35MDssXwWWK%0AeIIe9DB%2F%2F48tHLORjaFoH8mrDeY%3D%0A)

This section lets you configure the different delivery methods enabled for your survey:

* [email](#h_40f57ea6e5)
* [SMS](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md#h_d6a5ae0584)
* [WhatsApp](#h_eb4ddaa177)

The Target Entities section

![](https://downloads.intercomcdn.com/i/o/a50210op/1916554235/08c989342cf24c1ca0248c59756d/image.png?expires=1773057600\&signature=6dd066c9da77cf54761857ff540495d8a6ddffe9b0a1de48b949ff0b23e77177\&req=dSkmEMx7mYNcXPMW3nq%2BgVQwKbv1p1COwVVRxQakwSPpET4Rq6TBzaFGL%2BfI%0AUr%2BjBAY39JElF54d44jAqZMMMlQ%3D%0A)

This section lets you configure your survey’s [target entities](https://help.fullwhere.com/fr/articles/12703199-les-enquetes-de-satisfaction#h_916cfaa276) .

***

## Main survey page <a href="#h_fd6c17647b" id="h_fd6c17647b"></a>

Your survey’s main page contains the various fields your customers will need to complete.

The editor consists of three main panels:

* Left panel → add and design elements;
* Center panel → edit and preview in real time;
* Right panel → general survey settings.

### Customize the survey header <a href="#h_11ad321529" id="h_11ad321529"></a>

The header helps reinforce your survey’s visual identity and is shared across its various landing pages.\
It includes:

* A logo (brand or location logo);
* A cover photo, adjustable in height for optimal framing.

***

### Add a footer <a href="#h_3b7238decf" id="h_3b7238decf"></a>

You can enhance your form by adding a footer (or *footer*) to reinforce your brand image and make it easier to navigate to your external channels.\
The footer can contain:

* an image (for example, a secondary logo or illustration);
* two text blocks, one before and one after the image (legal notices, additional information, etc.);
* and external links to your social media pages or website

The footer is shared across the different landing pages for your survey.

***

### Add and configure fields <a href="#h_cb155ba494" id="h_cb155ba494"></a>

Available fields can be accessed from the Elements tab in the left panel.\
They can be added by dragging and dropping them into the central area, and arranged in one or two columns.

**Available field types**

* Customer details
  * Title → the customer's title (Mr., Ms., etc.).
  * Last name → the customer's last name
  * First name → the customer's first name
  * Email address → the customer's email
  * Phone number → the customer's phone number

{% hint style="warning" %}
You don't need to include these fields in automatic satisfaction survey emails. The customer's identity is already known, and the survey will be linked to their profile.
{% endhint %}

* **Information**
  * File upload → allows one or more files to be uploaded (attachments, supporting documents, etc.).
  * Calendar → adds a date selection field (useful for an appointment or an order).
  * Order reference → text field for entering an existing order number. You don't need to collect this information in an automatic email, since it is already linked to a purchase.
* **Options**
  * Multiple choice (checkbox) → lets respondents select several options from a predefined list.
  * Single choice (radio) → displays a list from which only one option can be selected.
  * Dropdown list → similar to single choice, but displayed as a dropdown menu.
* **Ratings**
  * NPS → lets you collect a customer's NPS (Net Promoter Score). The standard NPS question is: "How likely are you to recommend our company to a friend or colleague?"\
    You can add only one NPS question to your survey. To collect multiple ratings on different topics, use CSAT Stars or CSAT Smileys questions instead.
  * CSAT - Stars → lets respondents rate specific topics on a scale of 1 to 5 stars (Example: How would you rate the welcome you received?)
  * CSAT - 5 smileys → lets respondents rate specific topics using smileys ranging from Dissatisfied to Very satisfied (Example: How was your experience with our customer service?)
* **Text**
  * Short text → a single-line free-text field (ideal for a title, comment, etc.)
  * Long text → the main text field in the satisfaction survey, used to collect the customer's comments. A survey can contain only one Long text field.
* Group → a structural element for grouping several fields into a single block with an optional title.

Fields can be:

* Reordered by dragging and dropping (up to 2 per row);
* Deleted using the corresponding icon;
* Configured individually (using the gear icon).

These options appear when you hover over a form field.

#### Advanced field configuration <a href="#h_3f947c1cdf" id="h_3f947c1cdf"></a>

Each field can be configured using the gear icon that appears on hover:

**Conditional display**

You can set conditions to display a field only when certain criteria are met (e.g., show a follow-up question only if the score is below 6).\
Conditions can be combined using AND / OR operators.

To add conditional logic to a field, click the ⚙️ to the right of the field, then click Trigger conditions.\
You can then define the conditions under which the selected field should be displayed.

**"Other" field for choice questions**

For choice fields, you can enable the *"Other" field*, allowing the customer to enter a free-text answer if none of the options apply.

**Set selection limits for multiple-choice questions**

For Multiple choice (checkbox) fields, you can set a minimum and/or maximum number of options the user must select.\
These settings help ensure that responses are valid and prevent users from missing options or selecting too many.

* Minimum selections → requires users to select at least a certain number of options before they can submit the form.
* Maximum selections → limits the number of options users can select, keeping responses within a specified range.

**Duplicate a field**

You can use the Duplicate option to instantly create a copy of the selected field.\
This feature saves time when creating forms with similar fields (for example, several “Single choice” or “Short text” questions).

The duplicated field automatically retains:

* the original field type (text, choice, list, etc.);
* formatting and option settings (values, required field, etc.)

Note that display conditions are not duplicated.

***

### Customize the design <a href="#h_fbce34b113" id="h_fbce34b113"></a>

The Design tab in the left panel lets you set the colors, fonts, and visual styles of your survey.

You can change your form’s typography using Google Fonts.

#### Main colors <a href="#h_84d05a6396" id="h_84d05a6396"></a>

* title: the color of the form title
* subtitle: the color of the form subtitle
* section: the color of field group names
* divider: the color of the dividers between field groups
* accent: the color of radio buttons, checkboxes, and focused fields
* background: the form’s background color

#### Field colors and customization <a href="#h_fa8e2a21d1" id="h_fa8e2a21d1"></a>

* title: the color of field names
* text: the color of the text customers enter in text fields
* placeholder: the color of field placeholders
* background: the background color of fields
* option: the color of options in single-choice (radio) and multiple-choice (checkbox) fields
* rounded corners: choose from 3 corner-rounding options for fields
* border: the color of field borders.

#### Submit button colors and customization <a href="#h_cc41c7c6ed" id="h_cc41c7c6ed"></a>

* text: the color of the button text
* background: the button’s background color
* rounded corners: choose from 3 corner-rounding options for the button
* border: the color of the button border

#### Footer colors <a href="#h_4c3e899bb7" id="h_4c3e899bb7"></a>

* background: the footer’s background color
* text: the color of the footer text
* icons: the color of the footer’s social media icons

***

### General settings <a href="#h_9ef588de5e" id="h_9ef588de5e"></a>

The right panel contains the survey’s general settings:

* Survey name and description;
* Enabled sending channels (Email, SMS, WhatsApp);
* Language and automatic translation;
* Survey link (copy to share);
* Automatic redirect (before or after the survey, with a configurable threshold);
* Sending limit: minimum number of days between two requests sent to the same customer (with an option to apply it per target entity);
* Limit to recent data: restricts sending to recent interactions (for example, the last 2 days).

#### Manage translations

Set the survey language to match the language its content is written in. Enable automatic translation if you want to adapt the text to the customer’s language.

Custom translations are configured separately for the survey content, email, and SMS. First, open the relevant panel from the editor’s navigation menu:

* **Survey questions and text** : go to the **survey page**, then open **Translation → Custom translations** to adapt the questions and other form text.
* **Invitation email** : go to **Email**, then open **Custom translations** to adapt the email subject and text.
* **SMS message** : go to **SMS**, then open **Custom translations** to adapt the message text.

In the translation editor for the selected panel, choose the language you want to customize, then enter the desired text and save your changes. Repeat for the other languages. Translating the survey questions does not translate the email or SMS text, so remember to configure each panel you use.

When a message is sent, Fullwhere uses the custom translations for the customer's language, even if automatic translation is disabled. You can customize only some of the text: the rest is translated automatically if this option is enabled, or kept in the original language. If the customer's language is not specified or matches the survey language, the original text is used.

***

## Thank-you page <a href="#h_e7a846fde6" id="h_e7a846fde6"></a>

The Thank-you tab lets you customize the message displayed after the survey is submitted.\
You can add a title, text, and image.

The overall design of the thank-you page is inherited from the design of your survey's main page.

***

## Automatic redirection and redirect page <a href="#h_d2a178d4d6" id="h_d2a178d4d6"></a>

Surveys let you add automatic redirects to an external URL (for example, Google Reviews or TripAdvisor).

You can configure two types of redirect:

* Before the survey → lets you route customers based on an initial rating they give during the survey;
* After the survey → based on the average ratings given for rating-type questions and the configured redirect threshold.

#### Redirecting before the survey <a href="#h_edb7addc0b" id="h_edb7addc0b"></a>

You can redirect users before the survey directly through the choice block in the email template if you use this sending method. See [Email](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md#h_40f57ea6e5).

For other distribution methods, redirecting users before the survey requires setting up a redirect page, which includes:

* your survey logo
* your survey cover image
* a question (e.g. *How would you rate your experience?*)
* a *call to action* (*e.g. Give us your feedback by clicking one of the following options)*
* a redirect block, which can be one of the following types:
  * NPS
  * CSAT - Stars
  * CSAT - 5 Smilies
  * CSAT - 2 Smilies (binary)

The redirect block determines whether the customer is redirected to the external URL or to your survey, based on the redirect threshold you configure and the customer's choice.<br>

Redirects require you to first configure the redirect URLs for the survey's target entities ([see specific section](#h_8ad7c88c33)).\
​

***

## Define target entities <a href="#h_8ad7c88c33" id="h_8ad7c88c33"></a>

From the Target entities tab, you can specify the brands and/or locations covered by the survey. Defining a target entity lets you enable sends or obtain a specific link for a location or brand.

\
In the Target entities tab, you can find the following for each target:

* The associated area (location or brand);
* The redirect URL (to Google, TripAdvisor, etc.), if defined. It must be set for [the redirect](#h_d2a178d4d6) before or after the survey to be available for this target entity.
* The survey link specific to this entity (location or brand);
* The status (enabled or disabled).

***

## Configure sending channels <a href="#h_45fc3ee6ef" id="h_45fc3ee6ef"></a>

Surveys can be sent automatically by email, SMS, or WhatsApp.\
Each channel has its own settings in the corresponding panel.

### Email <a href="#h_40f57ea6e5" id="h_40f57ea6e5"></a>

* Sending email address: by default, satisfaction survey emails are sent from an @fullwhere-mail.com address. If you want to send your satisfaction surveys from your own email address, you need to [connect it to Fullwhere](https://docs.fullwhere.com/documentation/documentation-en/get-started/brands.md#h_97ac72314e). We recommend this option, which improves your email deliverability.
* Sender: the sender name displayed in your customers’ inboxes
* Email subject: the subject line of the email your customers receive
* Sending schedule: delay before sending (e.g., 1 day after the visit), sending days, and time.
* Automatic reminders: option to send reminders to non-respondents (number of reminders and time between reminders).
* Advanced sending conditions: filter by specific criteria (for example, visit type, purchase channel, customer email, etc.).

#### Configure the email template <a href="#h_7d89a449a0" id="h_7d89a449a0"></a>

The email template determines the appearance and content of the email your customers receive when invited to answer the survey.\
The editor lets you customize the layout, text, and visual elements to ensure an experience that is consistent with your brand.

You can add different content blocks by clicking the buttons available in the central area:

* Title → main sentence of your email (*e.g., Hello, thank you for your purchase*)
* Subtitle → to introduce the request (e.g., *We’d love to hear your feedback*).
* Paragraph → to ask the main question (e.g., *On a scale of 1 to 5, how would you rate your experience?*).
* Choice block → the choice block determines the *call to action* included in the email.\
  It can be one of several types:
  * NPS
  * CSAT - Stars
  * CSAT - 5 Smilies
  * CSAT - 2 Smilies (binary)
  * Button

{% hint style="info" %}
💡 If the pre-survey redirect is enabled, the choice block acts as a redirect block and sends your customers to the external URL or to the survey, depending on the redirect threshold selected in the email template.\
If the pre-survey redirect is enabled and you select a Button-type choice block, customers will be redirected to the [Redirect page](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md#h_d2a178d4d6).

If the pre-survey redirect is not enabled, customers will be redirected to the survey regardless of the choice block offered and which option they click.
{% endhint %}

* Thank-you block → message displayed at the end of the email (e.g., *Thank you for taking part!*).
* Link → adds a link (to your legal notices, privacy policy, website, etc.).

The email header can include a logo and a cover image.

To translate the invitation, stay in the **Email** panel and open **Custom translations**. Select the desired language, then customize the subject, body text, button, and choice block labels in your template. Save your changes for each language. These translations are configured separately from the survey question translations: see [Manage translations](#gerer-les-traductions).

{% hint style="info" %}
✍️ All email text can be built using variables to personalize it for each customer.\
​[See variables](#h_bd8c318c41).
{% endhint %}

#### Test your email template <a href="#h_7d89a449a0" id="h_7d89a449a0"></a>

To test the email template you configured, in the Email section, click **Send a test email**.

You will then be prompted to:

* select the sending email address
* enter the recipient of your test
* fill in the values of any variables in your template, if present

Click **Send** to send your test email.

### SMS <a href="#h_d6a5ae0584" id="h_d6a5ae0584"></a>

* SMS sender → Name displayed when the SMS is received (up to 11 characters).
* SMS text → The text of the SMS. The SMS text must include the {{url}} variable, which displays the link to your survey.\
  An SMS is a message containing between 1 and 160 characters, and 2 SMS messages contain between 161 and 306 characters. The number of SMS messages determines how many SMS credits are used for each send.
* Sending schedule: delay before sending (e.g., 1 day after the visit), sending days, and time.
* Automatic reminders: option to send reminders to non-respondents (number of reminders and time between reminders).
* Advanced sending conditions: filter by specific criteria (for example, visit type, purchase channel, customer email, etc.).

{% hint style="info" %}
💡 If redirection before the survey is enabled, customers will be redirected to the [Redirect page](#h_d2a178d4d6).\
If redirection before the survey is not enabled, customers will be redirected directly to the survey.
{% endhint %}

{% hint style="info" %}
✍️ The SMS text can be built using variables to personalize it for each customer.\
Please note: using variables can increase the length of the SMS, and therefore the number of credits used, depending on the replacement values.

\
[View variables](#h_bd8c318c41).
{% endhint %}

To translate the message, go to the **SMS**panel, then open **Custom translations**. Select the desired language, enter your version of the text, and save your changes. This translation also applies to the fallback SMS sent after a WhatsApp delivery failure. Keep the variables in your translations, especially `{{url}}`, which is required to include the link to the survey. See [Manage translations](#gerer-les-traductions) for the translation rules for non-customized text.

### WhatsApp <a href="#h_eb4ddaa177" id="h_eb4ddaa177"></a>

* The WhatsApp Template\
  Sending satisfaction surveys via WhatsApp requires using a WhatsApp template.\
  This template must be linked to a WhatsApp Business account [connected to Fullwhere](broken://pages/74124e0319fe38b12e7ffa0c4a22bf6e667d4cac).

{% hint style="warning" %}
📣 Your WhatsApp template must meet certain standards to work correctly with Fullwhere surveys.\
​[Read our complete guide here.](https://docs.fullwhere.com/documentation/documentation-en/capture/use-a-whatsapp-template-for-your-satisfaction-survey.md)
{% endhint %}

* SMS fallback option: If WhatsApp delivery fails because the recipient does not have WhatsApp, an SMS can be sent as a fallback. To configure this SMS, see the [SMS](https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md#h_d6a5ae0584).
* Sending schedule: delay before sending (e.g., 1 day after the visit), sending days, and time.
* Automatic reminders: option to send reminders to non-respondents (number of reminders and time between reminders).
* Advanced sending conditions: filter by specific criteria (for example, visit type, purchase channel, customer email, etc.).

***

## Publish <a href="#h_a91742ebab" id="h_a91742ebab"></a>

Once your survey is configured:

* Save your changes at any time;
* Preview the survey using the *Preview* button (top right);
* Activate the survey using the *Activate* button to make it available through the selected channels.

Surveys can be edited at any time and then reactivated without losing their history.

***

## Use variables to personalize your surveys <a href="#h_de14b09a3a" id="h_de14b09a3a"></a>

Variables automatically personalize your survey content based on the associated customer, brand, or order.\
​

They are dynamically replaced at the time of sending, making each communication unique and more engaging.\
​

For example, writing in an email *“Hello {{customer\_first\_name}}”* will display to the customer as *“Hello Jérôme”*.

Using variables helps you build closer relationships with your customers, improve response rates, and ensure a consistent, personalized experience across all channels.

### Variables available in emails and SMS messages <a href="#h_bd8c318c41" id="h_bd8c318c41"></a>

The following variables can be inserted directly into your email text or SMS text

| Variable                        | Description                                                                                                                    |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `{{store}}`                     | [Public name](https://docs.fullwhere.com/documentation/documentation-en/get-started/locations.md#h_bc9834e24a) of the location |
| `{{store_signature}}`           | Location signature                                                                                                             |
| `{{brand}}`                     | Brand name                                                                                                                     |
| `{{brand_signature}}`           | Brand signature                                                                                                                |
| `{{signature}}`                 | Location signature if available; otherwise, the brand signature                                                                |
| `{{customer_first_name}}`       | Customer first name                                                                                                            |
| `{{customer_last_name}}`        | Customer last name                                                                                                             |
| `{{customer_full_name}}`        | Customer full name                                                                                                             |
| `{{customer_civility}}`         | Customer title                                                                                                                 |
| `{{customer_feedback_count}}`   | Total number of feedback items submitted by the customer                                                                       |
| `{{customer_purchase_count}}`   | Total number of orders placed                                                                                                  |
| `{{customer_purchase_count_1}}` | Total number of orders placed + 1 (useful for a loyalty message)                                                               |
| `{{customer_purchase_amount}}`  | Customer's total cumulative purchase amount                                                                                    |
| `{{purchase_amount}}`           | Amount of the relevant order                                                                                                   |
| `{{purchase_external_id}}`      | External order ID                                                                                                              |
| `{{purchase_date}}`             | Order date                                                                                                                     |
| `{{url}}`                       | Direct link to the survey. This variable is required in your SMS text.                                                         |

{% hint style="info" %}
Usage example\
*Hello {{customer\_first\_name}}, thank you for your purchase on {{purchase\_date}} from {{brand}}! We'd love to hear what you think 👉 {{url}}.*
{% endhint %}

### Variables available on the redirect page <a href="#h_ee752470d4" id="h_ee752470d4"></a>

Some variables can also be inserted on the survey redirect page (for example, to say thank you or display a personalized message):

| Variable    | Description                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `{{store}}` | [Public name](https://docs.fullwhere.com/documentation/documentation-en/get-started/locations.md#h_bc9834e24a) of the location |
| `{{brand}}` | Brand name                                                                                                                     |

### Missing data and variable display <a href="#h_ac45d60f56" id="h_ac45d60f56"></a>

If the data associated with a variable is unavailable (for example, if the customer's first name is unknown), the variable will not be replaced when the message is sent.\
In that case, it will remain empty, but no extra space will be displayed, so the original text is not altered.

{% hint style="info" %}
Example: If the message contains “ *Hello {{customer\_first\_name}}, thank you for your visit* ” and no first name is known, the customer will receive “ *Hello, thank you for your visit* ”.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fullwhere.com/documentation/documentation-en/capture/satisfaction-surveys.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
