# Catalogs

# Catalogs overview | Developer Documentation

<div id="bkmrk-catalogs-overviewupd">## Catalogs overview

<div><span>Updated: Mar 3, 2026</span></div><div>WhatsApp catalogs let businesses showcase products and services directly within customer conversations. Instead of redirecting customers to external websites or apps, catalogs bring the browsing experience into the chat — customers can view products, explore options, and place orders without leaving WhatsApp.</div><div id="bkmrk-what-is-a-catalog"><div id="bkmrk-what-is-a-catalog-1"><div>### What is a catalog

</div></div></div><div>A catalog is a structured inventory of products or services that you upload to Meta and connect to your WhatsApp Business Account (WABA). Each catalog item includes details like name, description, price, images, and availability. Once connected, this inventory becomes the foundation for all commerce interactions on WhatsApp.</div><div>Catalogs support two categories of items:</div>
<span>**Products**: Physical or digital goods with attributes like price, SKU, and images.</span><span>**Services**: Offerings such as appointments, consultations, or subscriptions.</span><div id="bkmrk-how-catalog-commerce"><div id="bkmrk-how-catalog-commerce-1"><div>### How catalog commerce works

</div></div></div><div>WhatsApp catalog commerce involves four stages:</div>
<span></span><div>**Inventory upload** — You upload your product data to Meta through the [Commerce API](/books/meta-whatsapp/page/upload-inventory-to-meta-developer-documentation) or the [Meta Commerce Manager<span>⁠</span>](https://business.facebook.com/commerce/). This creates the catalog that powers all downstream interactions.</div><span></span><div>**Commerce configuration** — You configure commerce settings for your business phone number, including whether to enable cart functionality and catalog visibility. See [Set commerce settings](/documentation/business-messaging/whatsapp/catalogs/set-commerce-settings) for details.</div><span></span><div>**Product sharing** — You share products with customers using different message types — catalog messages, single product messages, multi-product messages, or carousel formats. See [Share products](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation) for all available formats.</div><span></span><div>**Customer responses** — Customers browse products, ask questions, and submit orders. You receive these interactions as [webhook notifications](/books/meta-whatsapp/page/receive-responses-from-customers-developer-documentation) containing order details and product inquiries.</div><div id="bkmrk-key-capabilities"><div id="bkmrk-key-capabilities-1"><div>### Key capabilities

</div></div></div><div id="bkmrk-product-sharing-form"><div id="bkmrk-product-sharing-form-1"><div>#### Product sharing formats

</div></div></div><div>WhatsApp supports several message formats for sharing catalog products, each suited to different use cases:</div>
<span>**Catalog messages** display a thumbnail of your full catalog, inviting customers to browse all available products.</span><span>**Single product messages** highlight one specific product with its image, price, and description.</span><span>**Multi-product messages** present a curated selection of up to 30 products organized into sections.</span><span>**Product carousel messages** show products in a horizontally scrollable card format.</span><div id="bkmrk-shopping-cart"><div id="bkmrk-shopping-cart-1"><div>#### Shopping cart

</div></div></div><div>When cart functionality is enabled, customers can add multiple products to a cart while browsing your catalog and submit a single order. The cart persists across the conversation, allowing customers to continue browsing and adding items before checking out.</div><div>A shopping cart:</div>
<span>Is unique to a customer/business chat thread on a specific device: Only one cart is created per chat thread between you and a customer, and carts do not persist across multiple devices. Once a cart is sent, the customer can open another cart with you and start the process again.</span><span>Has no expiration date: The cart persists in the chat thread until it is sent to you. Once sent, the cart is cleared.</span><div>Customers can add up to 99 units of each single catalog item to a shopping cart, but there is no limit on the number of distinct items that can be added to a cart.</div><div>Once a cart has been sent, no edits can be made. Customers can send a new cart if they need new items, or would like to change their order. You cannot send carts to customers.</div><div><div><div><div>![Shopping cart experience example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-s8ezuigv.jpeg)</div></div><div><div>![Expected behavior when item state changes in shopping cart](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-atmlfakb.jpeg)</div></div></div><div>*Shopping cart experience example and expected behavior for item state change.*</div></div><div id="bkmrk-policies"><div id="bkmrk-policies-1"><div>### Policies

</div></div></div><div>Never send messages that violate the Commerce and Business Policies. Additionally, multi-product and single-product messages are subject to the existing enforcement and data sharing rules for product catalogs:</div>
<span>**India compliance**: Businesses based in India must [comply with all online selling laws<span>⁠</span>](https://www.facebook.com/help/1104628230079278).</span><span>**Rejection at product catalog level**: WhatsApp automatically reviews items added to a catalog connected to a WABA. If a policy-violating item is added, the product is flagged and the business is directed to the WhatsApp Commerce Policies.</span><span>**Reporting options at the product catalog level**: Users can report a specific product they receive through a message. If a user reports a product, it is reviewed for violations.</span><div>Businesses can appeal for disapproved items directly in the [Meta Commerce Manager<span>⁠</span>](https://business.facebook.com/commerce/).</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div><div>Unlike product messages sent via the WhatsApp Business app, messages sent via the Cloud API currently do not display a shopping cart icon in the chat thread header.</div><div id="bkmrk-product-updates"><div id="bkmrk-product-updates-1"><div>### Product updates

</div></div></div><div>You may need to update properties of items in your catalog. Depending on the updated property, this is how messages that showcase that product are handled:</div><div><table><thead><tr><th><span>Updated Property </span></th><th><span>Update Process </span></th></tr></thead><tbody><tr><td><div><div>Product’s price, title, description, and image.</div></div></td><td><div>
<span>You send a product message containing product A.</span><span>You update product A’s properties in your catalog.</span><span>The screens that display that product are updated as soon as the customer client learns about the change from the server.</span></div></td></tr><tr><td><div><div>Availability change</div></div></td><td><div>
<span>You send a customer a product message containing product B.</span><span>You sell all units of product B available. Then, you update your catalog saying that product B is no longer available.</span><span>If a customer has already added product B to a cart, the item will be removed from the cart. The shopping cart displays a dialog saying “One or more items in your cart have been updated”.</span><span>If a customer has not added product B to the cart, the product message now shows the item as unavailable.</span></div></td></tr></tbody></table>

</div></div>

# Upload inventory to Meta | Developer Documentation

<div id="bkmrk-upload-inventory-to-">## Upload inventory to Meta

<div><span>Updated: Mar 3, 2026</span></div><div>A business’s inventory needs to be uploaded to Meta in a catalog format — see [About Catalogs<span>⁠</span>](https://www.facebook.com/business/help/890714097648074) for more information.</div><div>If a business already has a Meta catalog set up, leverage that catalog for WhatsApp commerce use cases. Just [connect the catalog to a WhatsApp Business Account<span>⁠</span>](https://www.facebook.com/business/help/158662536425974) (WABA) and the business will be able to [share products with customers](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation).</div><div>If a business needs to create a catalog, there are two possibilities:</div>
<span>Create a catalog using the [Commerce API](https://developers.facebook.com/docs/commerce-platform/catalog/get-started)</span><span>Create a catalog using the [Meta Commerce Manager<span>⁠</span>](https://business.facebook.com/commerce/).</span><div>You can only upload one catalog per WABA, but the same catalog can belong to multiple phone numbers.</div><div id="bkmrk-solution-partners"><div id="bkmrk-solution-partners-1"><div>### Solution Partners

</div></div></div><div>Solution Partners onboarding client businesses into commerce messages have the following options:</div>
<span>If a client business already has and manages their own Meta catalog, they can give permission to the Solution Partner to manage their catalog —these permissions are controlled via the [Meta Business Manager<span>⁠</span>](https://business.facebook.com/) and [Meta Commerce Manager<span>⁠</span>](https://business.facebook.com/commerce/). After that, the Solution Partner can [connect the WhatsApp Business Account to the catalog<span>⁠</span>](https://www.facebook.com/business/help/158662536425974) via WhatsApp Manager.</span><span>If a client business doesn’t have a Meta catalog, they can create and upload a new catalog under the Solution Partner’s business ID.</span></div>

# Share products with WhatsApp users | Developer Documentation

<div id="bkmrk-share-products-with-">## Share products with WhatsApp users

<div><span>Updated: Mar 3, 2026</span></div><div>You have multiple ways to share products with your customers.</div><div id="bkmrk-catalog-messages"><div id="bkmrk-catalog-messages-1"><div>### Catalog messages

</div></div></div><div>[Catalog messages](/books/meta-whatsapp/page/catalog-messages-developer-documentation) and [Catalog template messages](/books/meta-whatsapp/page/catalog-templates-developer-documentation) display a product thumbnail header image, custom body text, and a **View catalog** button. When a customer taps the button, your product catalog appears within WhatsApp.</div><div><div>![Catalog message example showing View catalog button](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-hfnf271k.png)</div></div><div id="bkmrk-catalog-link-message"><div id="bkmrk-catalog-link-message-1"><div>### Catalog link messages

</div></div></div><div>Use a [Catalog link messages](/books/meta-whatsapp/page/catalog-link-messages-developer-documentation) to send a link to your entire product catalog by assembling a wa.me link and including it in a standard [text message](/books/meta-whatsapp/page/sending-messages-developer-documentation).</div><div id="bkmrk-checkout-button-mess"><div id="bkmrk-checkout-button-mess-1"><div>### Checkout button messages

</div></div></div><div>[Checkout button template messages](/books/meta-whatsapp/page/checkout-button-templates-developer-documentation) allow India-based businesses to showcase one or more products that WhatsApp users in India (with India country calling codes) can purchase without leaving the WhatsApp client.</div><div>![Checkout button template example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-tfrejvbl.png)</div><div id="bkmrk-single-product-messa"><div id="bkmrk-single-product-messa-1"><div>### Single-product messages

</div></div></div><div>[Single-product messages](/books/meta-whatsapp/page/single-product-messages-developer-documentation) and [Single-product template messages](/books/meta-whatsapp/page/single-product-message-templates-developer-documentation) present a single product from your catalog, accompanied by a product image, product title, and product price, along with customizable body text, optional footer text, and an interactive **View** button.</div><div>![Single-product message template example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-dgjb3sl7.png)</div><div id="bkmrk-multi-product-messag"><div id="bkmrk-multi-product-messag-1"><div>### Multi-product messages

</div></div></div><div>[Multi-product messages](/books/meta-whatsapp/page/multi-product-messages-developer-documentation) and [Multi-product template messages](/books/meta-whatsapp/page/multi-product-message-templates-developer-documentation) display up to 30 products from your catalog, organized into customizable sections.</div><div>![Multi-product message template example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-wa8cunad.png)</div><div id="bkmrk-product-carousel-mes"><div id="bkmrk-product-carousel-mes-1"><div>### Product carousel messages

</div></div></div><div>[Product carousel messages](/books/meta-whatsapp/page/interactive-product-carousel-messages-developer-documentation) and [Product carousel template messages](/books/meta-whatsapp/page/product-card-carousel-templates-developer-documentation) allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view.</div><div>![Product card carousel template example](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-r4pnyokq.png)</div></div>

# Receive responses from customers | Developer Documentation

<div id="bkmrk-receive-responses-fr">## Receive responses from customers

<div><span>Updated: Mar 3, 2026</span></div><div>After receiving single- or multi-product messages, WhatsApp users can ask for more information about a product or place an order. These actions are communicated via the [messages](/books/meta-whatsapp/page/messages-webhook-reference-developer-documentation) webhook.</div><div id="bkmrk-sent-message-status"><div id="bkmrk-sent-message-status-1"><div>### Sent message status

</div></div></div><div>Sent message statuses (sent, delivered, read) are described in [status messages webhooks](/books/meta-whatsapp/page/status-messages-webhook-reference-developer-documentation).</div><div id="bkmrk-asking-for-informati"><div id="bkmrk-asking-for-informati-1"><div>### Asking for information

</div></div></div><div>Whenever a WhatsApp user receives a single- or multi-product message, they can ask for more information by sending you a text message in an existing WhatsApp thread, or by tapping a **Message business** or **Message** button when viewing a specific product.</div><div>Messages sent after tapping a **Message business** or **Message** button are described in [text messages webhooks](/books/meta-whatsapp/page/text-messages-webhook-reference-developer-documentation) and a `context` property will be included, whose value is an object describing the product the user was viewing when they tapped the button.</div><div id="bkmrk-orders"><div id="bkmrk-orders-1"><div>### Orders

</div></div></div><div>When a WhatsApp user adds one or more products to their WhatsApp shopping cart and places an order, the [order messages webhook](/books/meta-whatsapp/page/order-messages-webhook-reference-developer-documentation) is triggered, describing the contents of the order. Use the order contents to fulfill the order.</div></div>

# Catalog link messages | Developer Documentation

<div id="bkmrk-catalog-link-message">## Catalog link messages

<div><span>Updated: Mar 3, 2026</span></div><div>You can send a link to your entire product catalog by assembling a wa.me link and including it in a standard [text message](/books/meta-whatsapp/page/sending-messages-developer-documentation). When sending a text message, you can use the optional `preview_url` set to `true` to have the message render a set of product catalog thumbnails of any URL in the message `body` string.</div><div>Note that if you [disable the catalog](/documentation/business-messaging/whatsapp/catalogs/set-commerce-settings#enable-disable-catalog), wa.me links and the **View Catalog** button in catalog link messages display an **Invalid catalog link** message when tapped.</div><div>To assemble a wa.me link, append your business phone number, including country code, to the end of the following string:</div><div>```
<span>https</span><span>:</span><span>//wa.me/c/</span>
```

</div><div>For example:</div><div>```
<span>https</span><span>:</span><span>//wa.me/c/15555455657</span>
```

</div></div>

# Catalog messages | Developer Documentation

<div id="bkmrk-catalog-messagesupda">## Catalog messages

<div><span>Updated: Mar 3, 2026</span></div><div>Catalog messages let you showcase your product catalog entirely within WhatsApp.</div><div>Catalog messages display a product thumbnail header image of your choice, custom body text, a fixed text header, a fixed text sub-header, and a **View catalog** button.</div><div><div>![Catalog message example showing View catalog button](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-o4fikgti.png)</div></div><div>When a customer taps the **View catalog** button, your product catalog appears within WhatsApp.</div><div><div>![Product catalog displayed within WhatsApp](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-b5vou6o9.png)</div></div><div id="bkmrk-requirements"><div id="bkmrk-requirements-1"><div>### Requirements

</div></div></div><div>You must have [inventory uploaded to Meta](/books/meta-whatsapp/page/upload-inventory-to-meta-developer-documentation) in an ecommerce catalog [connected to your WhatsApp Business Account<span>?</span>](https://www.facebook.com/business/help/158662536425974).</div><div id="bkmrk-post-body"><div id="bkmrk-post-body-1"><div>### Post body

</div></div></div><div id="bkmrk-properties"><div id="bkmrk-properties-1"><div>### Properties

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<BODY_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Text to appear in the message body.</div><div>  
Maximum 1024 characters.</div></div></td><td><div><div>`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`</div></div></td></tr><tr><td><div><div>`<FOOTER_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>  
Text to appear in the message footer.</div><div>  
Maximum 60 characters.</div></div></td><td><div><div>`Best grocery deals on WhatsApp!`</div></div></td></tr><tr><td><div><div>`<THUMBNAIL_PRODUCT_RETAILER_ID>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>  
Item SKU number. Labeled as **Content ID** in the Commerce Manager.</div><div>  
The thumbnail of this item will be used as the message's header image.</div><div>  
If the `parameters` object is omitted, the product image of the first item in your catalog will be used.</div></div></td><td><div><div>`2lc20305pt`</div></div></td></tr><tr><td><div><div>`<TO>`</div><div>*String*</div></div></td><td><div><div>Customer phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr></tbody></table>

</div></div>

# Catalog templates | Developer Documentation

<div id="bkmrk-catalog-templatesupd">## Catalog templates

<div><span>Updated: Mar 3, 2026</span></div><div>This document explains how to create catalog templates. See [Sell Products &amp; Services](/books/meta-whatsapp/page/catalogs-overview-developer-documentation) to learn more about product catalogs and ways to showcase your products.</div><div>Catalog templates are marketing templates that allow you to showcase your product catalog entirely within WhatsApp. Catalog templates display a product thumbnail header image of your choice and custom body text, along with a fixed text header and fixed text sub-header.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-c4tpoqzc.png)</div><div>When a customer taps the **View catalog** button in a catalog template message, your product catalog appears within WhatsApp.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-mix1ikuq.png)</div><div id="bkmrk-creating-catalog-tem"><div id="bkmrk-creating-catalog-tem-1"><div>### Creating catalog templates

</div></div></div><div id="bkmrk-requirements"><div id="bkmrk-requirements-1"><div>#### Requirements

</div></div></div><div>You must have [inventory uploaded to Meta](/books/meta-whatsapp/page/upload-inventory-to-meta-developer-documentation) in an e-commerce catalog [connected to your WhatsApp Business Account<span>?</span>](https://www.facebook.com/business/help/158662536425974).</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>#### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<BODY_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Template body text. Variables are supported.</div><div>  
Maximum 1024 characters.</div></div></td><td><div><div>```
Now shop for your favorite products right here on WhatsApp! Get Rs {{1}} off on all orders above {{2}}Rs! Valid for your first {{3}} orders placed on WhatsApp!
```

</div></div></td></tr><tr><td><div><div>`<EXAMPLE_BODY_TEXT>`</div><div>*String (of an array of strings)*</div></div></td><td><div><div>**Required if body text uses variables.**</div><div>  
Sample strings to replace variable placeholders in `<BODY_TEXT>` string.</div><div>  
Maximum 1024 characters.</div></div></td><td><div><div>`100`</div></div></td></tr><tr><td><div><div>`<FOOTER_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>  
Template footer text. Variables are supported.</div><div>  
Maximum 60 characters.</div></div></td><td><div><div>`Best grocery deals on WhatsApp!`</div></div></td></tr><tr><td><div><div>`<LANGUAGE>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Template [language and locale code](/books/meta-whatsapp/page/template-library-developer-documentation).</div></div></td><td><div><div>`en_US`</div></div></td></tr><tr><td><div><div>`<NAME>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Template name.</div><div>  
Maximum 512 characters.</div></div></td><td><div><div>`intro_catalog_offer`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-sending-catalog-temp"><div id="bkmrk-sending-catalog-temp-1"><div>### Sending catalog template messages

</div></div></div><div>You can send approved [catalog templates](/books/meta-whatsapp/page/catalog-templates-developer-documentation) in a template message. See [Sell Products &amp; Services](/books/meta-whatsapp/page/catalogs-overview-developer-documentation) to learn more about product catalogs and ways to showcase your products.</div><div id="bkmrk-requirements-3"><div id="bkmrk-requirements-4"><div>#### Requirements

</div></div></div><div>You must have [inventory uploaded to Meta](/books/meta-whatsapp/page/upload-inventory-to-meta-developer-documentation) in an e-commerce catalog [connected to your WhatsApp Business Account<span>?</span>](https://www.facebook.com/business/help/158662536425974).</div><div id="bkmrk-request-parameters-3"><div id="bkmrk-request-parameters-4"><div>#### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<CODE>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Template [language and locale code](/books/meta-whatsapp/page/template-library-developer-documentation).</div></div></td><td><div><div>`en_US`</div></div></td></tr><tr><td><div><div>`<NAME>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Template name.</div></div></td><td><div><div>`intro_catalog_offer`</div></div></td></tr><tr><td><div><div>`<THUMBNAIL_PRODUCT_RETAILER_ID>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>  
Item SKU number. Labeled as Content ID in the Commerce Manager.</div><div>  
The thumbnail of this item will be used as the message's header image.</div><div>  
If the `parameters` object is omitted, the product image of the first item in your catalog will be used.</div></div></td><td><div><div>`2lc20305pt`</div></div></td></tr><tr><td><div><div>`<TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required if template uses variables.**</div><div>  
Template variable.</div></div></td><td><div><div>`100`</div></div></td></tr><tr><td><div><div>`<TO>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>  
Customer phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr><tr><td><div><div>`<TYPE>`</div><div>*String*</div></div></td><td><div><div>**Required if template uses variables.**</div><div>  
Template variable type.</div></div></td><td><div><div>`text`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-see-also"><div id="bkmrk-see-also-1"><div>### See also

</div></div></div>
<span>[Sell Products &amp; Services](/books/meta-whatsapp/page/catalogs-overview-developer-documentation)</span><span>[Catalog Messages](/books/meta-whatsapp/page/share-products-with-whatsapp-users-developer-documentation)</span></div>

# 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>

# Multi-product message templates | Developer Documentation

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

<div><span>Updated: Mar 3, 2026</span></div><div>This document describes multi-product message (“MPM”) templates, their uses, and how to use them.</div><div>MPM templates are marketing templates that allow you to showcase up to 30 products from your ecommerce catalog, organized in up to 10 sections, in a single message.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-x7kv5ifl.png)</div><div>Customers can browse products and sections within the message, view details for each product, add and remove products from their cart, and submit their cart to place an order. Orders are then sent to you via a webhook.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-6wpxhhhd.png)</div><div>See our help center article [About Multi-product message templates on WhatsApp<span>⁠</span>](https://www.facebook.com/business/help/978451836847222) for common use cases and tips on how to make the most of MPM templates.</div><div id="bkmrk-requirements"><div id="bkmrk-requirements-1"><div>### Requirements

</div></div></div><div>In order to create and use MPM templates you must have an ecommerce product catalog, with inventory, connected to your WhatsApp Business Account. See the Cloud API [Commerce](/books/meta-whatsapp/page/catalogs-overview-developer-documentation) guide.</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div>
<span>Customers must be using WhatsApp v2.22.24 or greater.</span><span>MPM templates cannot be forwarded to other customers.</span></div>

# Interactive product carousel messages | Developer Documentation

<div id="bkmrk-interactive-product-">## Interactive product carousel messages

<div><span>Updated: Mar 3, 2026</span></div><div>The interactive product carousel message enables businesses to send horizontally scrollable product cards within WhatsApp conversations, allowing users to browse and engage with products directly in-thread.</div><div>This format integrates with the Product Catalog and supports Single Product Message (SPM) actions on each card, providing a seamless and interactive shopping experience via the WhatsApp Business APIs and mobile clients.</div><div id="bkmrk-how-to-build-a-produ"><div id="bkmrk-how-to-build-a-produ-1"><div>### How to build a product carousel message

</div></div></div><div>The product carousel message contains a `card` object. You must add 2 card objects to your message, and can add a maximum of 10. Each card exists in a `cards[]` array and must be given a `"card_index"` value of `0` through `9`.</div><div>The type of each card must be set to `"product"`, and each card must reference the same `"catalog_id"`.</div><div>You must add a message body to the message, and no header, footer, or buttons are allowed.</div><div>Lastly, each card must specify the product and catalog identifiers `"product_retailer_id"` and `"catalog_id"`.</div><div id="bkmrk-the-card-object"><div id="bkmrk-the-card-object-1"><div>#### The `card` object

</div></div></div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<MESSAGE_BODY_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Maximum 1024 characters.</div></div></td><td><div><div>`Which option do you prefer?`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-card-object-paramete"><div id="bkmrk-card-object-paramete-1"><div>### Card object parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample value </span></th></tr></thead><tbody><tr><td><div><div>`<INDEX>`  
*Integer*</div></div></td><td><div><div>**Required**  
Unique index for each card (0-9). Must not repeat within the message.</div></div></td><td><div><div>`2`</div></div></td></tr><tr><td><div><div>`<PRODUCT_RETAILER_ID>`  
*String*</div></div></td><td><div><div>**Required**  
The unique retailer ID of the product in the catalog.</div></div></td><td><div><div>`"0JkSUu4qizuXv"`</div></div></td></tr><tr><td><div><div>`<CATALOG_ID>`  
*String*</div></div></td><td><div><div>**Required**  
The unique ID of the catalog containing the product.</div></div></td><td><div><div>`"Lq1ZtoWL5OkljTerAW"`</div></div></td></tr></tbody></table>

</div></div>

# Product card carousel templates | Developer Documentation

<div id="bkmrk-product-card-carouse">## Product card carousel templates

<div><span>Updated: Mar 3, 2026</span></div><div>Product card carousel templates allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-w54iflxt.png)</div><div>When a WhatsApp user taps the **View** button, they can view more information about the product, add the product to a shopping cart, and place an order, all without leaving the WhatsApp client experience. If instead you prefer to send the user to your website when they click the button, see [Media Card Carousel Templates](/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates).</div><div id="bkmrk-product-cards"><div id="bkmrk-product-cards-1"><div>### Product cards

</div></div></div><div>Carousel templates support up to 10 product cards, composed of message body text, a product image, product title, product price, and a single View button or URL button. All cards defined on a template must have the same components.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-jhtmxrnp.png)</div><div id="bkmrk-view-buttons"><div id="bkmrk-view-buttons-1"><div>### View buttons

</div></div></div><div>When a WhatsApp user taps the button, the product details view appears, displaying product information pulled from your product catalog.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-sytc16j6.png)</div><div>Users can then add the product to a cart and place an order.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-btb9p9an.png)</div><div>When a user submits the cart, a [webhook](#bkmrk-webhooks-1) will be triggered describing the order, and an order confirmation message will appear in the message thread.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-jwwu8hni.png)</div><div>Users who have placed an order can see the contents of the order by tapping the **View details** button.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-km1gt5oe.png)</div><div id="bkmrk-url-buttons"><div id="bkmrk-url-buttons-1"><div>### URL buttons

</div></div></div><div>Instead of **View** buttons you may wish to use **URL** buttons. When a WhatsApp user taps a URL button to buy a product, the URL mapped to the button is loaded in the device's default web browser, which takes the user out of the WhatsApp client experience. This can be useful if, for example, you wish to load the product in your mobile checkout page where users can add promo codes and find related products.</div><div>With URL button flows, since order placement happens outside of the WhatsApp client, webhooks describing the order are not triggered.</div><div id="bkmrk-catalogs"><div id="bkmrk-catalogs-1"><div>### Catalogs

</div></div></div><div>To use product card carousel templates, you must have an ecommerce product catalog, with inventory, connected to your WhatsApp Business Account. See the Cloud API [Commerce](/books/meta-whatsapp/page/catalogs-overview-developer-documentation) guide to learn more about connecting a catalog to your account.</div></div>

# 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>

# Single-product message templates | Developer Documentation

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

<div><span>Updated: Mar 3, 2026</span></div><div>This document describes single-product message (SPM) templates, their uses, and how to use them.</div><div>SPM templates are marketing templates that allow you to present a single product from your ecommerce catalog, accompanied by a product image, product title, and product price (all pulled from your product within your catalog), along with customizable body text, optional footer text, and an interactive **View** button.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-xqycngsi.png)</div><div>WhatsApp users can tap the button to see details about the product, and can add or remove the product from the WhatsApp shopping cart:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-mka2tzi6.png)</div><div>If the WhatsApp user adds the product to the cart and submits an order, you will be notified via webhook and the user will see that an order has been placed:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-y8humdpw.png)</div><div>Users who place an order are also able to use the View details button to see information about the order:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-rknkb0zw.png)</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div>
<span>Customers must be using WhatsApp v2.22.24 or greater.</span><span>Message forwarding is disabled for SPM templates.</span><div id="bkmrk-catalogs"><div id="bkmrk-catalogs-1"><div>### Catalogs

</div></div></div><div>You must have an ecommerce product catalog, with inventory, connected to your WhatsApp Business Account. See the Cloud API [Commerce](/books/meta-whatsapp/page/catalogs-overview-developer-documentation) guide to learn more about connecting a catalog to your account.</div></div>