# List

{% hint style="info" %}
This feature is only supported on the **WhatsApp channel** for the following WA API providers: 360Dialog, Meta, and GupShup.
{% endhint %}

This action block is used for a rich approach of allowing users to choose from a list of options. Mostly used as an alternative to the '[Option](broken://pages/T4ARPqGMJFF56MTWy4pK)' action block, as it is not user-friendly and prone to users from the users.

<figure><img src="https://2580337444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsrMxU8nO3RjusUiYuXBB%2Fuploads%2F3s5epgwFg7NxEh9Qe6vr%2FGroup%201.png?alt=media&#x26;token=40192a0e-16c2-4cb2-a63b-6398a56c1e22" alt=""><figcaption><p>Preview of list on WhatsApp </p></figcaption></figure>

## Configurations on the action block

### Header

Shows the text entered in a bold format -- making it look like a title.

### Body

The text will be the question associated with showing the list of options.&#x20;

### Footer

An optional field where a help text is entered. Mostly a disclaimer, visualized in a grey color.

### Button name

Along with the above, there will be a button that is displayed, on click of which will we show the list of options in a drawer format.&#x20;

Here you can write the name of the button like 'Choose', 'Select' etc.

### Items & Categories

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

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

{% hint style="info" %}
A maximum of **10** items and categories can be created.
{% endhint %}

### Variable

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

([Refer to this article to learn more about variables](broken://pages/yoQeaanOi6YcYGlLVEoj))

### Track links

Enabling this option will create short URLs for all the URLs mentioned in this action block.&#x20;

([Refer to this article](broken://pages/fXXTtx6OkxSObuZTFSuj))

{% hint style="warning" %}
This will only work if **Link tracking** is enabled in your account settings.
{% 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.swiftsell.biz/bot-builder/action-block/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.