List
Category: Input
Overview
The List node sends a WhatsApp Interactive List message — a tap-to-open menu of up to 10 rows organised under section headers. Each row is its own output port, so the flow branches per selection. Use it whenever you have more options than Button can fit (more than 3).
When to use
- Long menus (departments, languages, ticket categories).
- Catalog-style choices that don’t need rich media.
- Any branching choice with 4–10 options.
Ports
| Port | Direction | Description |
|---|---|---|
in | input | Receives the flow from the previous node. |
<row_key> | output | One output port per list row, named by the row’s stable key. Fires when the customer taps that row (or types its label). |
fallback | output | Fires when the customer’s reply doesn’t match any row’s key or label. |
Configuration
Prompt (EN / AR)
The bilingual body text shown above the list opener button.
Button label (EN / AR)
The bilingual text on the “open list” button that the customer taps to reveal the rows. WhatsApp caps this at 20 characters per language.
Sections
A list of sections, each with a section title and one or more rows underneath. Use sections to group related rows under headers; for a flat list, keep all rows in a single unnamed section. Each row has:
- Key — a stable internal id that doubles as the output port name (e.g.
english,arabic). - EN label — the English row title.
- AR label — the Arabic row title.
Limits & validation
- WhatsApp Interactive Lists cap a single message at 10 rows total across all sections; the channel adapter enforces this.
- WhatsApp truncates row labels longer than 24 characters per language.
See also
Button for ≤ 3 options; Card Carousel when you want a swipeable rich-media menu instead of a tap-to-open list.