# Send List {% embed url="" %} 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. ### **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** * Navigate to the **Send** category * Select **Send List** * 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. 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. 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**. 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 **Description** Additional details explaining the option. Example: Check your order status **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** * 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**. #### **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. #### **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**. ### **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**. --- # 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.ownchat.app/bot/send-action/send-list.md?ask= ``` 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.