# List Option

## Overview 

This Card offers a selection of up to 10 options, facilitating user choice and enhancing interactions with your business in a clear and uniform way.

## When to Use the Node:

Here are some examples of how you can utilize List Messages in different industry scenarios:

<table><thead><tr><th width="166">Industry	</th><th width="276">Scenario - 1	</th><th>Scenario - 2</th></tr></thead><tbody><tr><td>Education</td><td><p></p><p><strong>Course Information:</strong></p><ul><li>View Available Courses</li><li>Review Course Timetables</li><li>Discover Faculty Members</li><li>Obtain Syllabus Information</li></ul></td><td><p></p><p><strong>Admissions:</strong></p><ul><li>Understand Admission Criteria</li><li>Explore Undergraduate Offerings</li><li>Look at Graduate Programs</li><li>Application Deadlines</li></ul></td></tr><tr><td>HealthCare</td><td><p></p><p><strong>Appointment Services:</strong></p><ul><li>Book an Appointment</li><li>View Available Slots</li><li>Appointment Reminders</li><li>Rescheduled Appointments</li></ul></td><td><p></p><p><strong>Health Information:</strong></p><ul><li>Discover Health Services</li><li>Locate Medical Facilities</li><li>Health and Wellness Resources</li><li>Health Insurance Information</li></ul></td></tr><tr><td>Travel</td><td><p></p><p><strong>Flight Information:</strong></p><ul><li>Look Up Flights</li><li>Verify Flight Availability</li><li>Departure and Arrival times</li><li>Review Airline Choices</li></ul></td><td><p></p><p><strong>Hotel Booking:</strong></p><ul><li>Search for Hotels</li><li>Review Room Prices</li><li>Discover Hotel Amenities</li><li>Reserve a Room</li></ul></td></tr><tr><td>Real Estate</td><td><p></p><p><strong>Property Search:</strong></p><ul><li>Discover Properties Available</li><li>Access Details on Properties</li><li>See Photos and Virtual Tours</li><li>Schedule a Viewing</li></ul></td><td><p></p><p><strong>Mortgage Services:</strong></p><ul><li>Explore Mortgage Options</li><li>Review Interest Rates</li><li>Obtain Pre-Approval Information</li><li>Submit a Mortgage Application</li></ul></td></tr><tr><td>E-Commerce</td><td><p></p><p><strong>Product Catalog:</strong></p><ul><li>Browse Product Categories</li><li>Explore Featured Products</li><li>Review Product Specifications</li><li>Place Products in the Cart</li></ul></td><td><p></p><p><strong>Order Management:</strong></p><ul><li>Monitor Order Status</li><li>Review Past Orders</li><li>Initiate Returns or Exchanges</li><li>Check Delivery Choices</li></ul></td></tr></tbody></table>

## How to use it:

The Ask List Option Message Node has 6 fields - Header, Question Text, Footer, Button Name, Options Type, Attempt, Validation Error Message, Action on Invalid Response, and Variables.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FoPqIIzDPOxUsvkM6ysu0%2FScreenshot%202025-09-16%20154429.png?alt=media&#x26;token=0f5ef9a2-0d21-47ab-b5bc-e575cb6ef75e" alt=""><figcaption></figcaption></figure>

## **Header**&#x20;

You could use text such as "Start Your Journey with Our Customer Service" or "Frequently Asked Questions on Our Products and Services."

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FLpZ6da7m4slcbwZyIzGR%2FScreenshot%202024-06-11%20193252.png?alt=media&#x26;token=22b270a3-67b1-4557-a931-2c592f738696" alt=""><figcaption></figcaption></figure>

## **Question Text**&#x20;

"Welcome! Navigate through our comprehensive FAQs to assist yourself. Choose an option that best suits your needs." This format allows endless possibilities for engaging and guiding your customers effectively.

The text here can be formatted as Bold, Italic, or Strikethrough using the provided options. To make text Bold, wrap it with asterisks (\*), for Italic use underscores (\_), and for Strikethrough, use tildes (\~).

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FZydHNOGfgchtcetHANgr%2FScreenshot%202024-06-11%20193626.png?alt=media&#x26;token=1d2a44ba-ec1c-49be-8a72-f96b79aa2fbf" alt=""><figcaption></figcaption></figure>

## Footer&#x20;

Utilize this section to append extra details related to the message, like your organization’s contact information or a brief tagline. An example used here is "XYZ Retail Group." Customize the content to suit your preferences.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FL2XjVqLYmAGMXF81hpsc%2FScreenshot%202024-06-11%20194716.png?alt=media&#x26;token=316737a8-c33c-4a54-8df7-87e9b70b03ad" alt=""><figcaption></figcaption></figure>

## Options Type

Choose from Static or Dynamic Options for your buttons.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FqiFw66KN4Hgjy1EEu27k%2FScreenshot%202024-06-11%20194830.png?alt=media&#x26;token=f17e5547-e6a0-4ff0-88cc-cedc3beb5234" alt=""><figcaption></figcaption></figure>

**Static Options** remain constant, while Dynamic Options are updated dynamically, pulling data from your database through an API call if needed.

{% hint style="info" %}
You may include up to 10 buttons, which can be arranged into various sections as required.
{% endhint %}

Below is the example of how you can add the Static Options.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FwQNNYJO5JjkGRLqTTzHf%2FScreenshot%202025-09-16%20155827.png?alt=media&#x26;token=1508f578-1323-46aa-9368-b822bc672cb1" alt=""><figcaption></figcaption></figure>

For the **Dynamic Options** in the Ask List Option, there are three fields you need to fill: Variable to iterate, Path to ID, and Path to Title.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FEHTzdzUPRvEApwh3s28r%2FScreenshot%202025-09-16%20155937.png?alt=media&#x26;token=ba18e2ed-db4d-45bd-a2f3-33a3734b158a" alt=""><figcaption></figcaption></figure>

* **Variable to iterate:** Enter the name of the array here.
* **Path to ID:** Provide the path from your internal database within curly brackets.
* **Path to Title:** Enter the title in curly brackets, for example, {{first\_name}}.

{% hint style="info" %}
Please note:

* If multiple options are included within the same section, it can be sent without a section name.
* If there is more than one section, then a section header is required to create the card.
  {% endhint %}

## Advanced Settings

**Attempt:** Specify the number of times you would like to repeat the question to your customers if they provide an incorrect or unexpected response.

**Action on Invalid Response:** This setting determines what action to take when a customer provides an invalid response. You can choose to End the Flow or Skip the question.

**Validation Error Message:** This message is displayed to customers when they provide an invalid response. For example, if the customer doesn't respond with one of the given options, you might send a message like "Please choose from the above options" or "Select one of the listed options."

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2FRmTDcB9jYvyTIxgn5AVO%2FScreenshot%202024-06-12%20142723.png?alt=media&#x26;token=04d913f5-e675-4f27-8581-57accafdf12b" alt=""><figcaption></figcaption></figure>

## **Save Response in a Variable:**

You can create new variables or use existing ones to store the responses from your customers. If you're creating variables for the first time, simply type the variable's name in the box; you will be prompted to create the variable by clicking on "Create 'Variable Name'" as shown in the screenshot below.

<figure><img src="https://789614814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCr7uCTpZRGEF8A48OOJ%2Fuploads%2F5AT5jetZR4nCBjDZrBPt%2FScreenshot%202024-06-12%20150026.png?alt=media&#x26;token=3c2e072b-0d7e-44df-9905-5864719b2e1a" alt=""><figcaption></figcaption></figure>

After setting all the required fields and click SAVE.


---

# 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.bizmagnets.ai/bot-flows/ask-questions/list-option.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.