List Messages

List messages present a menu of options in a scrollable list format. This is a WhatsApp-specific message type.

Overview

A list message consists of:

• Header text — Optional title at the top
• Body text — The main message content
• Footer text — Optional footer
• Button label — Text on the call-to-action button (e.g., "View Options")
• List sections — One or more sections, each containing items

Sections & Items

Each section can have:

• Section title — Header for the group of options
• Items — Up to 10 items per section, each with:
  • Title (required)
  • Description (optional)
  • Row ID (for flow processing)

Interaction

1. The contact sees the message with a button
2. Tapping the button reveals the scrollable list
3. The contact selects an item
4. Their selection is sent as a reply and can be processed by a flow

Limits