Catalogs Catalogs overview | Developer Documentation Catalogs overviewUpdated: Mar 3, 2026WhatsApp 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. What is a catalogA 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.Catalogs support two categories of items: Products: Physical or digital goods with attributes like price, SKU, and images.Services: Offerings such as appointments, consultations, or subscriptions. How catalog commerce worksWhatsApp catalog commerce involves four stages: Inventory upload — You upload your product data to Meta through the Commerce API or the Meta Commerce Manager⁠. This creates the catalog that powers all downstream interactions.Commerce configuration — You configure commerce settings for your business phone number, including whether to enable cart functionality and catalog visibility. See Set commerce settings for details.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 for all available formats.Customer responses — Customers browse products, ask questions, and submit orders. You receive these interactions as webhook notifications containing order details and product inquiries. Key capabilities Product sharing formatsWhatsApp supports several message formats for sharing catalog products, each suited to different use cases: Catalog messages display a thumbnail of your full catalog, inviting customers to browse all available products.Single product messages highlight one specific product with its image, price, and description.Multi-product messages present a curated selection of up to 30 products organized into sections.Product carousel messages show products in a horizontally scrollable card format. Shopping cartWhen 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.A shopping cart: 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.Has no expiration date: The cart persists in the chat thread until it is sent to you. Once sent, the cart is cleared.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.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. Shopping cart experience example and expected behavior for item state change. PoliciesNever 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: India compliance: Businesses based in India must comply with all online selling laws⁠.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.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.Businesses can appeal for disapproved items directly in the Meta Commerce Manager⁠. LimitationsUnlike 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. Product updatesYou 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: Updated Property Update Process Product’s price, title, description, and image. You send a product message containing product A.You update product A’s properties in your catalog.The screens that display that product are updated as soon as the customer client learns about the change from the server. Availability change You send a customer a product message containing product B.You sell all units of product B available. Then, you update your catalog saying that product B is no longer available.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”.If a customer has not added product B to the cart, the product message now shows the item as unavailable. Upload inventory to Meta | Developer Documentation Upload inventory to MetaUpdated: Mar 3, 2026A business’s inventory needs to be uploaded to Meta in a catalog format — see About Catalogs⁠ for more information.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⁠ (WABA) and the business will be able to share products with customers.If a business needs to create a catalog, there are two possibilities: Create a catalog using the Commerce APICreate a catalog using the Meta Commerce Manager⁠.You can only upload one catalog per WABA, but the same catalog can belong to multiple phone numbers. Solution PartnersSolution Partners onboarding client businesses into commerce messages have the following options: 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⁠ and Meta Commerce Manager⁠. After that, the Solution Partner can connect the WhatsApp Business Account to the catalog⁠ via WhatsApp Manager.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. Share products with WhatsApp users | Developer Documentation Share products with WhatsApp usersUpdated: Mar 3, 2026You have multiple ways to share products with your customers. Catalog messagesCatalog messages and Catalog template messages 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. Catalog link messagesUse a Catalog link messages to send a link to your entire product catalog by assembling a wa.me link and including it in a standard text message. Checkout button messagesCheckout button template messages 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. Single-product messagesSingle-product messages and Single-product template messages 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. Multi-product messagesMulti-product messages and Multi-product template messages display up to 30 products from your catalog, organized into customizable sections. Product carousel messagesProduct carousel messages and Product carousel template messages allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view. Receive responses from customers | Developer Documentation Receive responses from customersUpdated: Mar 3, 2026After 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 webhook. Sent message statusSent message statuses (sent, delivered, read) are described in status messages webhooks. Asking for informationWhenever 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.Messages sent after tapping a Message business or Message button are described in text messages webhooks and a context property will be included, whose value is an object describing the product the user was viewing when they tapped the button. OrdersWhen a WhatsApp user adds one or more products to their WhatsApp shopping cart and places an order, the order messages webhook is triggered, describing the contents of the order. Use the order contents to fulfill the order. Catalog link messages | Developer Documentation Catalog link messagesUpdated: Mar 3, 2026You can send a link to your entire product catalog by assembling a wa.me link and including it in a standard text message. 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.Note that if you disable the catalog, wa.me links and the View Catalog button in catalog link messages display an Invalid catalog link message when tapped.To assemble a wa.me link, append your business phone number, including country code, to the end of the following string: https://wa.me/c/For example: https://wa.me/c/15555455657 Catalog messages | Developer Documentation Catalog messages Updated: Mar 3, 2026 Catalog messages let you showcase your product catalog entirely within WhatsApp. 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. When a customer taps the View catalog button, your product catalog appears within WhatsApp. Requirements You must have inventory uploaded to Meta in an ecommerce catalog connected to your WhatsApp Business Account?. Post body Properties Placeholder Description Sample Value String Required. Text to appear in the message body. Maximum 1024 characters. Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase. String Optional. Text to appear in the message footer. Maximum 60 characters. Best grocery deals on WhatsApp! String Optional. Item SKU number. Labeled as Content ID in the Commerce Manager. The thumbnail of this item will be used as the message's header image. If the parameters object is omitted, the product image of the first item in your catalog will be used. 2lc20305pt String Customer phone number. +16505551234 Catalog templates | Developer Documentation Catalog templates Updated: Mar 3, 2026 This document explains how to create catalog templates. See Sell Products & Services to learn more about product catalogs and ways to showcase your products. 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. When a customer taps the View catalog button in a catalog template message, your product catalog appears within WhatsApp. Creating catalog templates Requirements You must have inventory uploaded to Meta in an e-commerce catalog connected to your WhatsApp Business Account?. Request parameters Placeholder Description Sample Value String Required. Template body text. Variables are supported. Maximum 1024 characters. 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! String (of an array of strings) Required if body text uses variables. Sample strings to replace variable placeholders in string. Maximum 1024 characters. 100 String Optional. Template footer text. Variables are supported. Maximum 60 characters. Best grocery deals on WhatsApp! String Required. Template language and locale code. en_US String Required. Template name. Maximum 512 characters. intro_catalog_offer Sending catalog template messages You can send approved catalog templates in a template message. See Sell Products & Services to learn more about product catalogs and ways to showcase your products. Requirements You must have inventory uploaded to Meta in an e-commerce catalog connected to your WhatsApp Business Account?. Request parameters Placeholder Description Sample Value String Required. Template language and locale code. en_US String Required. Template name. intro_catalog_offer String Optional. Item SKU number. Labeled as Content ID in the Commerce Manager. The thumbnail of this item will be used as the message's header image. If the parameters object is omitted, the product image of the first item in your catalog will be used. 2lc20305pt String Required if template uses variables. Template variable. 100 String Required. Customer phone number. +16505551234 String Required if template uses variables. Template variable type. text See also Sell Products & ServicesCatalog Messages Multi-product messages | Developer Documentation Multi-product messages Updated: Mar 3, 2026 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. Multi-Product message example: Menu triggered when user clicks on Start Shopping: Overview Customers that receive Multi-Product Messages can perform 3 main actions: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.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 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 for details.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. 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 for details. Currently, Multi-Product Messages can be received on the following platforms:iOS: 2.21.100Android: 2.21.9.15Web: The web client supports this feature. 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. Expected behavior Multi-Product Messages can be:Forwarded by one user to another.Reopened by a user within the same chat thread. Multi-Product Messages cannot be:Sent as notifications. They can only be sent as part of existing chat threads. Use cases Multi-Product Messages are best for guiding customers to a specific subset of your inventory, such as: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.Navigating to a specific category. For example, fitness apparel.Personalized offers or recommendations.Re-ordering previously ordered items. For example, a user can re-order their regular take-out order of less than 30 items. 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. Why you should use them 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. Simple and efficient 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. Personal 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. Business outcomes A high-performing channel for driving orders. During testing, businesses had an average 7% conversion of Multi-Product Messages sent to carts received. No templates 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. Send a multi-product message Before sending product messages, follow the get started best suited for your needs:Direct developersSolution providers 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 > WhatsApp > API Setup panel. If you are a solution provider, you must authenticate with an access token with the whatsapp_business_messaging permission. Step 1: Assemble the interactive object To send a Multi-Product Message, assemble an interactive object of type product_list with the following components: Required Components Optional Components Header Object — Header’s type must be set to text. Remember to add a text object with the desired content.Body ObjectAction Object - Must include catalog_id and sections. Sections must be an array of objects describing each section using title and product_items. 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. Footer Object See Messages, Interactive Object for full information. By the end of the process, the interactive object should look something like this: Missing items 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. At least one item from the products list must match an item from your product catalog. In this case:Messages are sent successfullyItems without a match are droppedYou receive an error message asking for a catalog update Multi-product message templates | Developer Documentation Multi-product message templates Updated: Mar 3, 2026 This document describes multi-product message (“MPM”) templates, their uses, and how to use them. 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. 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. See our help center article About Multi-product message templates on WhatsApp⁠ for common use cases and tips on how to make the most of MPM templates. Requirements 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 guide. Limitations Customers must be using WhatsApp v2.22.24 or greater.MPM templates cannot be forwarded to other customers. Interactive product carousel messages | Developer Documentation Interactive product carousel messages Updated: Mar 3, 2026 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. 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. How to build a product carousel message 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. The type of each card must be set to "product", and each card must reference the same "catalog_id". You must add a message body to the message, and no header, footer, or buttons are allowed. Lastly, each card must specify the product and catalog identifiers "product_retailer_id" and "catalog_id". The card object Request parameters Placeholder Description Sample Value String Required. System token or business token. EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD String Optional. Graph API version. v25.0 String Required. Maximum 1024 characters. Which option do you prefer? String Required. WhatsApp business phone number ID. 106540352242922 String Required. WhatsApp user phone number. +16505551234 Card object parameters Placeholder Description Sample value Integer Required Unique index for each card (0-9). Must not repeat within the message. 2 String Required The unique retailer ID of the product in the catalog. "0JkSUu4qizuXv" String Required The unique ID of the catalog containing the product. "Lq1ZtoWL5OkljTerAW" Product card carousel templates | Developer Documentation Product card carousel templates Updated: Mar 3, 2026 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: 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. Product cards 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. View buttons When a WhatsApp user taps the button, the product details view appears, displaying product information pulled from your product catalog. Users can then add the product to a cart and place an order. When a user submits the cart, a webhook will be triggered describing the order, and an order confirmation message will appear in the message thread. Users who have placed an order can see the contents of the order by tapping the View details button. URL buttons 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. With URL button flows, since order placement happens outside of the WhatsApp client, webhooks describing the order are not triggered. Catalogs 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 guide to learn more about connecting a catalog to your account. Single-product messages | Developer Documentation Single-product messages Updated: Mar 3, 2026 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. Single-Product message example: Product Detail Page example: Overview Customers that receive Single-Product Messages can perform 3 main actions: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.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 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 for details.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. 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 for details. Currently, Single-Product Messages can be received on the following platforms:iOS: 2.21.210Android: 2.21.19Web: The web client supports this feature. 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. Expected behavior Single-Product Messages can be:Forwarded by one user to another.Reopened by a user within the same chat thread. Single-Product Messages cannot be:Sent as notifications. They can only be sent as part of existing chat threads. Use cases 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:Responding to a customer’s specific request.Providing a recommendation.Reordering a previous item. 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. Why you should use them 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. No templates 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. Send a single-product message Before sending product messages, follow the get started best suited for your needs:Direct developersSolution providers 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 > WhatsApp > API Setup panel. If you are a solution provider, you must authenticate with an access token with the whatsapp_business_messaging permission. Step 1: Assemble the interactive object To send a Single-Product Message, assemble an interactive object of type product with the following components: Required Components Optional Components Action Object — Must include both catalog_id and product_retailer_id. Body ObjectFooter Object See Messages, Interactive Object for full information. By the end of the process, the interactive object should look something like this: 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. Single-product message templates | Developer Documentation Single-product message templates Updated: Mar 3, 2026 This document describes single-product message (SPM) templates, their uses, and how to use them. 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. WhatsApp users can tap the button to see details about the product, and can add or remove the product from the WhatsApp shopping cart: 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: Users who place an order are also able to use the View details button to see information about the order: Limitations Customers must be using WhatsApp v2.22.24 or greater.Message forwarding is disabled for SPM templates. Catalogs You must have an ecommerce product catalog, with inventory, connected to your WhatsApp Business Account. See the Cloud API Commerce guide to learn more about connecting a catalog to your account.