What Is a WhatsApp List Message?
A List Message is an interactive WhatsApp Business API message that presents recipients with a tappable menu — a button that expands into a scrollable list of up to 10 clearly labelled options grouped under section headers. Instead of asking a customer to type "1 for balance, 2 for statement, 3 for support", you send a single tidy menu they select from with one tap. Because the reply comes back as structured data, your bot or flow knows exactly which option was chosen with zero free-text guesswork. For Indian businesses running catalogues, service menus, appointment slots, or branch selectors on WhatsApp, List Messages turn a cluttered text prompt into a fast, unambiguous choice — which lifts completion rates and cuts the mistakes that plague number-and-keyword menus.
In one line
A WhatsApp List Message shows a tappable menu of up to 10 labelled options under section headers, so customers pick instead of type — cleaner than numbered text menus and it returns a structured reply your bot can act on directly.How a List Message is structured
A List Message has three moving parts. First, the message body carries your prompt text plus an optional header (text, and in newer versions a short title) and footer. Second, a single call-to-action button — you choose its label, e.g. "View services" or "Pick a slot" — which opens the menu when tapped. Third, the list itself: one or more sections, each with an optional section title, containing rows. Each row has a unique ID (invisible to the customer, returned to you on selection), a visible title, and an optional one-line description. The customer taps the button, scrolls the list, and selects one row. WhatsApp then sends your webhook an interactive reply containing that row's ID and title, so your application routes the conversation deterministically.
- Sections group related rows (e.g. "Loans", "Cards", "Support")
- Row IDs let your bot branch logic without parsing text
- Titles and descriptions are what the customer actually sees
- One button opens the whole menu — the list is hidden until tapped
List Message vs Reply Buttons vs Carousel
WhatsApp gives you several interactive formats and choosing the right one matters. Reply Buttons show up to three options as always-visible tap targets — ideal for quick yes/no/maybe branches where every choice must be seen at a glance. A List Message is the better fit when you have four to ten options and want them tucked behind one clean button rather than crowding the chat. A Carousel Template scrolls horizontally through image cards with their own buttons — that's for showcasing products visually, not for a compact text menu. As a rule of thumb: two or three choices, use reply buttons; a menu of up to ten text choices, use a List Message; visual product browsing, use a carousel or link to your WhatsApp Catalog.
- Reply Buttons: up to 3, always visible — fast binary or triple branches
- List Message: up to 10, hidden behind one button — menus and selectors
- Carousel: image cards — visual product showcases
When List Messages shine for Indian businesses
List Messages are at their best inside the free 24-hour service window, when a customer has messaged you first and you're guiding them through a self-service flow — checking an order, booking a slot, selecting a branch, or navigating a support tree. Because you can send free-form interactive messages during that window, a List Message here costs nothing extra in messaging fees and dramatically shortens the path to resolution. Real-world uses across Indian sectors include clinics offering appointment times, NBFCs presenting loan or repayment options, D2C brands showing product categories, logistics firms letting customers pick a delivery window, and utilities routing complaint types. The structured reply means your automation, or your agents in a shared inbox, always knows the exact intent without deciphering typos or regional spelling.
Cost, templates, and the service window
How you deliver a List Message affects whether it's billable. Inside the 24-hour customer service window, interactive List Messages are free session messages — you're only replying to an active conversation. To send outside that window you must use an approved template, and WhatsApp bills per delivered message by category (marketing, utility, or authentication). Since 1 July 2025 Meta bills per delivered message rather than per conversation; the 24-hour window is a free service window for replying to customers, not a billing unit. Interactive list components are supported in certain template types, so if your menu goes out as a business-initiated template it carries that template's category rate. InfiQ applies transparent ₹ pricing (ex-GST), so you always see the per-message cost by category before you send at scale.
- Inside the 24-hour service window: List Messages are free session replies
- Outside it: send via an approved template, billed per delivered message by category
- Category (marketing / utility / authentication) sets the rate
- Meta bills per delivered message since 1 July 2025 — not per conversation
Common mistakes to avoid
The most frequent error is overloading the menu — WhatsApp caps you at 10 rows total across all sections, so trying to cram 15 branches into one list will fail validation. Next is exceeding character limits: button labels max out at 20 characters, row titles at 24, and descriptions at 72, and long Hindi or regional-language strings hit these ceilings faster than English. Teams also forget that row IDs must be unique and stable, then break their webhook routing when they reshuffle the menu. Another trap is assuming List Messages work identically on every WhatsApp client — always test on both Android and iOS. Finally, don't try to send a cold, business-initiated List Message outside the service window without an approved template; it simply won't deliver, and you'll wonder why your menu never reached the customer.
- Never exceed 10 rows total — split long menus into a two-step flow
- Watch the 20 / 24 / 72 character limits, especially in regional scripts
- Keep row IDs unique and stable so webhook routing doesn't break
- Use an approved template to send outside the 24-hour window
Frequently asked questions
How many options can a WhatsApp List Message have?+
Is a List Message free to send?+
What is the difference between a List Message and Reply Buttons?+
What data does WhatsApp return when a customer taps a list option?+
Can I send a List Message in Hindi or other Indian languages?+
Do List Messages need template approval?+
What are the character limits for a List Message?+
When should I use a Carousel instead of a List Message?+
Build tap-to-select menus on WhatsApp
Talk to an InfiQ onboarding specialist to design List Messages, flows, and templates that fit your customer journeys — on transparent ₹ pricing, with full BSUID ownership.