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