# Multi-product messages | Developer Documentation

<div id="bkmrk-multi-product-messag">## Multi-product messages

<div><span>Updated: Mar 3, 2026</span></div><div>Multi-Product Messages are interactive messages that display up to 30 products from your catalog, organized into sections. Customers can browse products, view details, add items to a cart, and send an order — all within WhatsApp.</div><div><div><div><div><div>*Multi-Product message example:*</div></div></div><div><div><div>*Menu triggered when user clicks on Start Shopping:*</div></div></div><div><div>![Multi-Product message example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-hfbgxjge.jpeg)</div></div><div><div><div>![Shopping menu triggered by Start Shopping button](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-mpvmegmk.jpeg)</div></div></div></div></div><div id="bkmrk-overview"><div id="bkmrk-overview-1"><div>### Overview

</div></div></div><div>Customers that receive Multi-Product Messages can perform 3 main actions:</div><span>View products: Customers can see a list of products. Whenever a customer clicks on a specific item, the product’s latest info is fetched and the product displays in a Product Detail Page (PDP) format. Currently, PDPs only support product images — any videos or GIFs added to the product won’t be displayed in the PDP.</span><span>Add products to a cart: Whenever a user adds a product to the shopping cart, the item’s latest info is fetched. If there has been a state change on any of the items, a dialog saying “One or more items in your cart have been updated” is displayed — see [Product updates](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation) for more information. A cart persists in a chat thread between you and your customer until the cart is sent to you — see [Shopping cart experience](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation) for details.</span><span>Send a shopping cart to you: After adding all needed items, customers can send their cart to you. After that, you can define the next steps, such as requesting delivery info or giving payment options.</span><div>If your customer has multiple devices linked to their account, Multi-Product Messages will be synced between devices. However, the shopping cart is local to each specific device. See [Shopping cart experience](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation) for details.</div><div>Currently, Multi-Product Messages can be received on the following platforms:</div><span>iOS: 2.21.100</span><span>Android: 2.21.9.15</span><span>Web: The web client supports this feature.</span><div>If the customer’s app version does not support Multi-Product Messages, they will instead receive a message explaining that they were unable to receive a message because they are using an outdated version of WhatsApp. You also receive a webhook notification indicating the message was unable to be delivered due to the customer using an outdated version of WhatsApp.</div><div id="bkmrk-expected-behavior"><div id="bkmrk-expected-behavior-1"><div>### Expected behavior

</div></div></div><div>Multi-Product Messages can be:</div><span>Forwarded by one user to another.</span><span>Reopened by a user within the same chat thread.</span><div>Multi-Product Messages cannot be:</div><span>Sent as notifications. They can only be sent as part of existing chat threads.</span><div id="bkmrk-use-cases"><div id="bkmrk-use-cases-1"><div>### Use cases

</div></div></div><div>Multi-Product Messages are best for guiding customers to a specific subset of your inventory, such as:</div><span>Shopping in a conversational way. For example, using search functionality to allow customers to type a shopping list and send back a Multi-Product Message in response.</span><span>Navigating to a specific category. For example, fitness apparel.</span><span>Personalized offers or recommendations.</span><span>Re-ordering previously ordered items. For example, a user can re-order their regular take-out order of less than 30 items.</span><div>Multi-Product Messages can also be used as part of a human agent flow. However, you need to build the tooling to allow the human agent to generate a Multi-Product Message in thread.</div><div id="bkmrk-why-you-should-use-t"><div id="bkmrk-why-you-should-use-t-1"><div>#### Why you should use them

</div></div></div><div>Multi-Product Messages lend themselves best to user experiences that are simple and personalized, where it’s a better experience to guide the customer to a subset of items most relevant to them, rather than browsing your full inventory.</div><div id="bkmrk-simple-and-efficient"><div id="bkmrk-simple-and-efficient-1"><div>##### Simple and efficient

</div></div></div><div>Combining the features with navigation tools like Natural Language Processing (NLP), text search or List Messages and Reply Buttons to get to what the customer is looking for fast.</div><div id="bkmrk-personal"><div id="bkmrk-personal-1"><div>##### Personal

</div></div></div><div>Populated dynamically so can be personalized to the customer or situation. For example, you can show a Multi-Product Message of a customer’s most frequently ordered items.</div><div id="bkmrk-business-outcomes"><div id="bkmrk-business-outcomes-1"><div>##### Business outcomes

</div></div></div><div>A high-performing channel for driving orders. During testing, businesses had an average 7% conversion of Multi-Product Messages sent to carts received.</div><div id="bkmrk-no-templates"><div id="bkmrk-no-templates-1"><div>##### No templates

</div></div></div><div>Interactive messages do not require templates or pre-approvals. They are generated in real-time and will always reflect the latest item details, pricing and stock levels from your inventory.</div><div id="bkmrk-send-a-multi-product"><div id="bkmrk-send-a-multi-product-1"><div>### Send a multi-product message

</div></div></div><div>Before sending product messages, follow the get started best suited for your needs:</div><span>[Direct developers](/books/meta-whatsapp/page/get-started-developer-documentation)</span><span>[Solution providers](/books/meta-whatsapp/page/solution-providers-developer-documentation)</span><div>All API calls mentioned in this guide must be authenticated with an access token. You can authenticate your API calls with the access token generated in the **App Dashboard** &gt; **WhatsApp** &gt; **API Setup** panel. If you are a solution provider, you must authenticate with an access token with the [whatsapp\_business\_messaging](https://developers.facebook.com/docs/permissions/reference/whatsapp_business_messaging) permission.</div><div id="bkmrk-step-1%3A-assemble-the"><div id="bkmrk-step-1%3A-assemble-the-1"><div>#### Step 1: Assemble the interactive object

</div></div></div><div>To send a Multi-Product Message, assemble an `interactive` object of type `product_list` with the following components:</div><div><table><thead><tr><th><span>Required Components </span></th><th><span>Optional Components </span></th></tr></thead><tbody><tr><td><div><span>Header Object — Header’s type must be set to text. Remember to add a text object with the desired content.</span><span>Body Object</span><span>Action Object - Must include catalog\_id and sections. </span><span>Sections must be an array of objects describing each section using title and product\_items. </span><span>Each section’s product\_items value must be an array describing each product in the section using product\_retailer\_id and the product’s SKU number.</span></div></td><td><div><span>Footer Object</span></div></td></tr></tbody></table>

</div><div>See [Messages, Interactive Object](/books/meta-whatsapp/page/sending-messages-developer-documentation) for full information. By the end of the process, the interactive object should look something like this:</div><div id="bkmrk-missing-items"><div id="bkmrk-missing-items-1"><div>##### Missing items

</div></div></div><div>If none of the items provided in the API call matches a product from your product catalog, an error message is sent and the Multi-Product Message is not sent to the user.</div><div>At least one item from the products list must match an item from your product catalog. In this case:</div><span>Messages are sent successfully</span><span>Items without a match are dropped</span><span>You receive an error message asking for a catalog update</span></div>