# List

Renders a list of items grouped by categories on a drawer.

Available on WhatsApp for the WA API providers: 360Dialog, Meta, and GupShup.

This action block is used for a rich approach of allowing users to choose from a list of options.

Most commonly, it is used as an alternative to the '[Option](/wotsabot-help-articles/bot-builder/action-blocks/options.md)' action block, as it it not user-friendly and prone to users from the users.

Preview of list on WhatsApp

<figure><img src="https://help.wotnot.io/~gitbook/image?url=https%3A%2F%2F360969599-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsrMxU8nO3RjusUiYuXBB%252Fuploads%252F3s5epgwFg7NxEh9Qe6vr%252FGroup%25201.png%3Falt%3Dmedia%26token%3D40192a0e-16c2-4cb2-a63b-6398a56c1e22&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ee10f86377a603698323ec7d795cf3ef54831cda5ef142dad5e726f18dd61a9d" alt=""><figcaption></figcaption></figure>

List action block is made up of the following:

1. Header
2. Body
3. Footer
4. Button name
5. Items & categories
6. Error message
7. Variable

#### Header <a href="#header" id="header"></a>

Shows the text in a bold format -- making it look like a title. It is an optional field.

#### Body <a href="#body" id="body"></a>

The text will be the question associated with showing the list of options.

For example, "Select the service you are interested in".

#### Footer <a href="#footer" id="footer"></a>

The text is displayed in a small grey color format. Mostly used to display a disclaimer to the user when selecting the option from the list.

#### Button name <a href="#button-name" id="button-name"></a>

Along with the above, a button will be displayed, on click of which we will show the list of options in a drawer format.

You can write the button's name here, such as 'Choose', 'Select', etc.

#### Items & Categories <a href="#items-and-categories" id="items-and-categories"></a>

All the items that are to be displayed in the list are defined here. Each item contains the following information,

* **Item name** - Name of the item
* **Item description** - A short description of the item
* **Category** - List of all categories created. It is optional.

On the bot builder canvas, for each list item, you will see a new branch created. You can use this to create personalized flows.

A maximum of **10** items and categories can be created.

#### Variable <a href="#variable" id="variable"></a>

Users can store the value of the selected list item in a variable for future reference.

[Learn more](/wotsabot-help-articles/variables.md)

\ <br>


---

# 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://help.wotsabot.ai/wotsabot-help-articles/bot-builder/action-blocks/list.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.