Guide · Interactive messaging
1,500+ businesses 4.4/5 on G2 Meta Business Partner

WhatsApp List Messages: What They Are and How to Use Them

The 30-second answer

A WhatsApp list message is an interactive format on the WhatsApp Business API that lets a customer pick from up to 10 options across up to 10 sections in one tap, instead of typing a reply you have to interpret. It's best for menus, catalogues, and category pickers — for a simple yes/no or A-vs-B choice, reply buttons (max 3) are the better fit. List messages only exist on the API, not the free WhatsApp Business app.

Key facts
  • Up to 10 rows total, grouped across up to 10 sections, per the official WhatsApp Cloud API limits.
  • Reply buttons cap out at 3 options — list messages are the format for a real menu or catalogue.
  • List messages are an API-only feature — not available on the free WhatsApp Business app.
  • The customer's tap returns structured data, ready for automation, instead of free text a bot has to guess at.

Quick answers

Q: What is a WhatsApp list message? A: An interactive menu inside a WhatsApp chat — the customer taps one button, a list opens, and they pick from up to 10 options without typing anything.
Q: When should I use a list message instead of buttons? A: Buttons (max 3) work for a quick either/or. Lists (up to 10 rows) work when the customer is choosing from a real menu, category, or catalogue.
Q: Can a chatbot handle what happens after the tap? A: Yes. On Go4whatsup, a list-message tap can trigger the next step automatically — a follow-up list, a confirmation, or a handoff to AI auto-reply or a live agent.
Choosing a format Reply buttons List message
Max options 3 buttons, shown directly in chat 10 rows total, across up to 10 sections
Best for Quick yes/no or A-vs-B decisions A real menu, category list, or catalogue
How it looks Buttons visible immediately under the message One "View options" button opens a scrollable menu
Where it works WhatsApp Business API only WhatsApp Business API only

A customer wants to order, and typing the full request is the slowest part of the conversation. List messages replace that typing with one tap — up to 10 options, structured, on the WhatsApp Business API. Here's what the format actually is, when it beats a button, and how real orders move through it.

Up to 10 options, one tapStructured replies, not free textTies into AI auto-reply
10Max rowsAcross up to 10 sections, per WhatsApp's official API limit
3Max reply buttonsUse buttons instead when it's a simple either/or
Faster ordersMOJ Water, after moving its catalogue to a list-message flow
100+LanguagesAuto-translate works on the text around the list, in any language

Why this matters now

Every WhatsApp order starts with a choice — a size, a flavor, a delivery slot, a plan tier. Left as free text, that choice becomes a small negotiation: the customer types something ambiguous, the agent (or bot) has to interpret it, and if it's wrong, there's a second message just to fix it. Multiply that across every order and it's the single biggest source of friction in an otherwise fast channel.

WhatsApp list messages exist to remove that friction. Instead of asking a customer to type a reply, the business sends a message with a single "View options" button. Tapping it opens a scrollable menu of up to 10 rows, grouped into up to 10 sections with an optional header and footer. The customer taps once, and what comes back to the business isn't a guess — it's the exact row they picked, structured and ready for automation.

Where most guides on this stop short

Most existing explainers on this topic show the format's UI — a screenshot of a menu popping open — and stop there. What they skip is the decision that actually matters to a business building a flow: when a list message beats a button, and when it doesn't. Reaching for a list every time isn't right either — for a genuine two-option choice, a list adds a tap (open menu, then pick) that a button skips entirely.

The simple rule: if a customer would say "yes" or "no" — or choose between two things — use reply buttons (max 3). If a customer is choosing from a real menu, a category, or a catalogue — use a list message (up to 10 rows). Both are WhatsApp Business API features; neither exists on the free WhatsApp Business app.

How Go4whatsup uses list messages

On Go4whatsup, a list message is rarely a standalone message — it's a step inside an automated flow. A customer texts "Hi," and the flow can open straight into a catalogue as a list message: pick a category, pick an item, pick a quantity, confirm. Each tap narrows the next list, and the whole exchange stays inside WhatsApp with no app switch and no typing beyond the first message.

The structural point is the same one that matters for any WhatsApp API evaluation: interactive formats like list messages are what separate a real automation build from a business typing replies by hand. See how the pieces fit together on the AI WhatsApp tools comparison.

Ready to try it?
Turn your catalogue into a tap-through list message — start free with Go4whatsup. No credit card, no sales call.
Start free

Real proof: businesses running orders through list messages

MOJ Water — a premium bottled-water brand in Kuwait — rebuilt its entire ordering flow on Go4whatsup: a customer texts "Hi," browses the catalogue as an interactive list message, picks a quantity, selects an address, and confirms payment without leaving the chat. The result: orders processed 5× faster, because checkout-in-chat killed the form abandonment and manual re-entry the old phone-and-web-form process created. Revenue tripled in the following quarter on the same product, market, and delivery fleet.

Matilda Cake — a custom-cake business in Dubai — mapped its menu and pricing tiers to interactive list messages in week one of its Go4whatsup setup, alongside its WhatsApp Business API and green-tick application. The ordering flow that followed cut order confirmations to 3× faster than the old phone-call process, with design notes and dietary preferences captured structured, inside the same thread the kitchen team already reads.

Both builds share the same underlying move: replace a typed request with a tap, and the order moves faster because there's nothing left to interpret.

How to get started

Turning a menu or catalogue into a list-message flow is not a rebuild:

  1. Start free — the free-forever plan needs no credit card.
  2. Connect your WhatsApp Business API number — Go4whatsup handles setup under its Meta Business Partner status.
  3. Map your menu or catalogue to a list — up to 10 rows per list, with follow-up lists for anything larger.

If you'd rather see it working on your own catalogue first, book a live demo and bring your current menu or price list.

See a list-message flow on your own number

Watch a real catalogue turn into a tap-through list message, live, in a 15-minute demo.

Book a live demo Start free

Frequently asked questions

Try it before you commit

Talk to us — free onboarding on your real number.

Book a working demo on your real WhatsApp number. Our team walks you through setup, builds your first list-message flow, and answers pricing questions. No credit card, no obligation.

Book a working demo
What is a WhatsApp list message?

A WhatsApp list message is an interactive format on the WhatsApp Business API that shows a customer a tappable menu instead of asking them to type a reply. The customer taps a button, a menu opens, and they pick one option from up to 10 rows — the choice is sent back structured, ready for automation, instead of arriving as free-form text your system has to interpret.

How many options can a WhatsApp list message have?

Up to 10 rows total, grouped across up to 10 sections, per the official WhatsApp Cloud API limits. Each row title is capped at 24 characters and each row description at 72 characters, so list messages work best for menus, catalogues, and short option sets rather than long product descriptions.

What's the difference between list messages and reply buttons?

Reply buttons show up to 3 choices directly in the chat as tappable buttons — best for quick yes/no or A-vs-B decisions. List messages hide the options behind one "View options" button that opens a scrollable menu of up to 10 rows — best when a customer is choosing from a real menu, category list, or catalogue rather than a simple either/or.

Do I need the WhatsApp Business API to send list messages?

Yes. Interactive list messages are a WhatsApp Business API (Cloud API) feature — they are not available on the free WhatsApp Business app. Businesses that need this format have to move the number to the official API, which is what Go4whatsup sets up under its Meta Business Partner status.

Can list messages be automated with a chatbot?

Yes. On Go4whatsup, a list message is typically the first step in an automated flow — the customer's tap triggers the next message, whether that's a confirmation, a follow-up list, or a handoff to AI auto-reply or a live agent. The structured tap data means the bot never has to guess what a free-text reply meant.

Are list messages available in the free WhatsApp Business app?

No. List messages, reply buttons, and other interactive formats only exist on the WhatsApp Business API. The free WhatsApp Business app is a phone-based, one-agent tool and does not support interactive message types at all.