> For the complete documentation index, see [llms.txt](https://docs.ownchat.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ownchat.app/bot/send-action/send-list.md).

# Send List

The **Send List** action allows you to send a **structured list of selectable options** to users within a chatbot conversation.

Instead of displaying buttons, this feature presents options in a **scrollable list format**, allowing users to browse and select one item from multiple choices.

Send List is useful when you need to present **more than three options**, keeping the conversation organized and easy to navigate.

{% embed url="<https://app.supademo.com/demo/cmm8s5dmk56tsdtfhf27jn5z3?utm_source=link>" %}

### **When to Use Send List**

Use the **Send List** action when users must choose from a **larger set of options**.

**Common Use Cases**

* Product or service categories
* Help center options
* Support request categories
* Order tracking and account options
* Multi-option menus

Example list shown to users:

Main Menu\
\
View Products\
Pricing Plans\
Track Order\
Contact Support

When the user selects an option, the chatbot continues the flow based on the selected item.

### **How to Add Send List**

Follow these steps to add a **Send List** action in your bot workflow:

* Open **Bot Builder**
* Click **Add Node**

{% embed url="<https://app.supademo.com/demo/cmp2ln3a102cxw80jo7kkyq8t?utm_source=link>" %}

* Navigate to the **Send** category
* Select **Send List**

{% embed url="<https://app.supademo.com/demo/cmp2lvuc40016zy0jtgfr4vkh?utm_source=link>" %}

* Configure the list message and options
* Click **Create**

Once added, the Send List node will appear in the bot flow where users can select one of the available options.

### **Send List Configuration**

When creating a Send List action, you must configure several fields.

#### **Action Name**

The **Action Name** identifies the action within the bot builder workflow.

This name is visible only inside the bot configuration.

{% embed url="<https://app.supademo.com/demo/cmp2ly2gg02yaur0j7ug6jdmy?utm_source=link>" %}

Example:

Main Menu List\
Support Menu\
Service Selection

#### **Header Text**

The **Header Text** appears at the top of the list message and provides context for the available options.

Example:

Main Menu

This field helps users understand the purpose of the list.

#### **Body Text**

The **Body Text** contains the main message displayed before the list options.

{% embed url="<https://app.supademo.com/demo/cmp2lzbrw02i0w80jmg935830?utm_source=link>" %}

Example:

Welcome!\
\
Please select one of the options below to continue.

The body text can also include **variables and formatting**.

#### **Footer Text**

The **Footer Text** appears below the message and provides additional instructions.

Example:

Choose an option to proceed

#### **Button Text**

The **Button Text** defines the label shown on the expandable list button.

Example:

View Options

When users tap this button, the full list of options appears.

#### **List Type**

The Send List action supports two list types.

**Static List**

In a **Static List**, the options are manually added inside the configuration panel.

You can add up to **10 list options**.

{% embed url="<https://app.supademo.com/demo/cmp2m1lxy03h9xn0jdilgqvgh?utm_source=link>" %}

Each option includes:

* Option Title
* Description
* ID

Example:

| Option          | Description               |
| --------------- | ------------------------- |
| View Products   | Browse available products |
| Pricing Plans   | View subscription plans   |
| Track Order     | Check your order status   |
| Contact Support | Get help from our team    |

Static lists are best when the options are **fixed and do not change frequently**.

**Dynamic List**

A **Dynamic List** retrieves options from a **variable containing structured data**.

This allows list items to be generated dynamically from:

* API responses
* Database results
* Previous workflow steps

Dynamic configuration fields include:

* Variable Name
* Variable Path
* Variable Key Title
* Variable Key Description
* Variable Key ID

Dynamic lists are useful when displaying **changing or real-time data**.

### **Adding List Options**

When using a static list, you must configure each option.

Each option includes the following fields:

**Option**

The title of the list item.

Example:

Track Order

{% embed url="<https://app.supademo.com/demo/cmp2m4k01030uur0jgilkqoas?utm_source=link>" %}

**Description**

Additional details explaining the option.

Example:

Check your order status

{% embed url="<https://app.supademo.com/demo/cmp2m2pgr03hbxn0j4ey4aoyz?utm_source=link>" %}

**ID**

A unique identifier for the option.

The system uses this ID to track the selected option and trigger the next action.

### **Adding More Options**

To include additional options:

* Click **Add New Menu**

{% embed url="<https://app.supademo.com/demo/cmp2m8jzs031eur0jdddr6td8?utm_source=link>" %}

* Enter the option title
* Add a description
* Provide a unique ID

A maximum of **10 options** can be included in a single Send List message.

#### **Error Attempt**

Users may sometimes reply with text instead of selecting an option.

The **Error Attempt** field determines how many invalid responses are allowed.

Example:

Error Attempt: 2

If the user exceeds the allowed attempts, the chatbot will trigger the selected **Action on Invalid**.

{% embed url="<https://app.supademo.com/demo/cmp2m9lex02xdwz0jaov109tw?utm_source=link>" %}

#### **Error Message**

The **Error Message** is displayed when the user provides an invalid input.

Example:

Please select a valid option to proceed.

This helps guide the user back to the available list options.

{% embed url="<https://app.supademo.com/demo/cmp2mbcpg0345yy0jxw47m3br?utm_source=link>" %}

#### **Action on Invalid**

This option determines what happens when the user exceeds the allowed error attempts.

Available options include:

**End the Flow**

Stops the chatbot flow.

**Skip the Question**

Allows the chatbot to continue to the next step.

**Fall Back Flow**

Redirects the user to another predefined action.

Fallback flows help guide users back to the correct conversation path.

### **Store Response in Variable**

You can store the selected list option in a **variable**.

Example:

Variable: selected\_menu\_option

This stored value can be used later in:

* Conditional logic
* Personalized messages
* Workflow automation

### **Example Interaction**

Example chatbot interaction using Send List:

Message:

Welcome!\
\
Please select one of the options below.

List Options:

View Products\
Pricing Plans\
Track Order\
Contact Support

If the user selects **Track Order**, the chatbot can automatically redirect them to the **order tracking flow**.

{% embed url="<https://app.supademo.com/demo/cmp2mcgfl031qur0j4i0acaix?utm_source=link>" %}

### **Best Practices**

Follow these recommendations when using Send List.

**Organize options clearly**

Group related options under a clear menu title.

**Keep option titles short**

Short titles improve readability and selection.

**Use helpful descriptions**

Descriptions help users understand what each option does.

**Limit list size**

Avoid overwhelming users with too many options.

### **Summary**

The **Send List** action enables chatbot builders to present **multiple selectable options in a structured list format**.

With Send List, you can:

* Display up to **10 selectable options**
* Provide descriptions for each option
* Organize menu-based conversations
* Retrieve dynamic list data from variables
* Store user selections for workflow automation

This feature helps create **organized, scalable, and user-friendly chatbot interactions**.