List Button

5 min

Introduction

This command allows you to send an interactive list menu with categorized options. It is useful for structured surveys, multi-option selections, or guided responses where the user must choose one item from different sections.

List preview

Action preview

Command Syntax

How it works

#ListMix → Defines the message type as a list with sections and options.

Title → Main text displayed at the top of the message.

Subtitle → Secondary text displayed below the title.

Footer → Text displayed at the bottom of the message.

xxx → Reserved placeholder (must remain as xxx for compatibility).

Action → The label shown on the button that opens the list (e.g., Action, Choose Option).

Section-1, Section-2, … → Logical groups that organize the options.

OptionDescriptionid → Each option inside a section:

Option → The visible label in the list.

Description → Additional detail shown under the option.

id → The unique identifier of the response.

Example

Result

The user receives a message with a title, subtitle, footer, and an Action button.

When the user clicks Action, a structured list opens with the defined sections and options.

The user selects one option, and the system records the response with its corresponding ID.

The CRM may use this response to:

Save it in the database.

Trigger an automation flow (e.g., thank-you message, support alert).

⚠️ Important Notes

IDs must be unique and consistent across the system.

Keep option texts and descriptions short and clear to ensure proper display on all devices.

Use sections to organize multiple choices logically; avoid more than 10 options per list for better usability.

The placeholder xxx must always be included as shown in the syntax.

Works only on WhatsApp clients that support interactive lists (ensure device compatibility).