# Single-product messages | Developer Documentation

<div id="bkmrk-single-product-messa">## Single-product messages

<div><span>Updated: Mar 3, 2026</span></div><div>Single-Product Messages are interactive messages that display a single product from your catalog, allowing customers to view product details, add the item to a cart, and send an order — all within WhatsApp.</div><div><div><div><div><div>*Single-Product message example:*</div></div></div><div><div><div>*Product Detail Page example:*</div></div></div><div><div>![Single-Product message example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-tyzjtood.jpeg)</div></div><div><div><div>![Product Detail Page example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-s6vzvhvv.jpeg)</div></div></div></div></div><div id="bkmrk-overview"><div id="bkmrk-overview-1"><div>### Overview

</div></div></div><div>Customers that receive Single-Product Messages can perform 3 main actions:</div><span>View the product: Whenever a customer clicks on the 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 the product 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, 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 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, Single-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, Single-Product Messages can be received on the following platforms:</div><span>iOS: 2.21.210</span><span>Android: 2.21.19</span><span>Web: The web client supports this feature.</span><div>If the customer’s app version does not support Single-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>Single-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>Single-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>Single-Product Messages are best for guiding customers to one specific item from your inventory, offering quick responses from a limited set of options, such as:</div><span>Responding to a customer’s specific request.</span><span>Providing a recommendation.</span><span>Reordering a previous item.</span><div>Single-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 Single-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>Single-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 specific item most relevant to them, rather than browsing your full inventory.</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-single-produc"><div id="bkmrk-send-a-single-produc-1"><div>### Send a single-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 Single-Product Message, assemble an `interactive` object of type `product` 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>Action Object — Must include both catalog\_id and product\_retailer\_id.</span></div></td><td><div><span>Body Object</span><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>If none of the items provided in the API call matches a product from your product catalog, an error message is sent and the Single-Product Message is not sent to the user.</div></div>