> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Show Shopify products as WhatsApp product cards

> Show your Shopify products as native WhatsApp product cards with cart support

WhatsApp Catalog lets your Chatbase AI agent sell your Shopify products on WhatsApp by sending them as native WhatsApp product cards. It's for Shopify stores that take customer conversations on WhatsApp and want shoppers to browse, fill a cart, and order in the same chat. When a shopper asks to see products, they get product cards with images, titles, and prices instead of plain text links, and the AI agent carries the cart through to the order.

This feature connects your Shopify product catalog to WhatsApp through Meta's commerce infrastructure. Products sync from Shopify to a Meta catalog, which WhatsApp then uses to render native product cards.

> [!NOTE]
>
> **Prerequisites:**
>
> * Your [Shopify integration](https://chatbase.co/docs/user-guides/integrations/shopify.md) must be set up.
> * The [Retrieve and display products](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#1-retrieve-and-display-products) Action must be enabled on your AI agent.
> * Your [WhatsApp channel](https://chatbase.co/docs/user-guides/integrations/whatsapp.md) must be connected.

## Setup

The setup involves six parts: installing Meta's Facebook & Instagram app on Shopify, creating a Meta catalog, publishing your products, assigning Chatbase as a partner, connecting the catalog in WhatsApp Manager, and confirming the connection in Chatbase.

### Part 1: Install the Facebook & Instagram app on Shopify

**1. Open the Shopify App Store**

Go to the [Facebook & Instagram app](https://apps.shopify.com/facebook) on the Shopify App Store and click **Install**.

![Facebook & Instagram app on the Shopify App Store](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/shopify-app-store.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=1ec1938fb81212f201d01297b8531d1f)

**2. Approve permissions**

Review the permissions the app needs (customer data, staff data, store data) and click **Install**.

![Install app permissions dialog](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/install-app.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=3e641efaa999a8ddd44cfd81fc82c36e)

**3. Get started**

Once installed, the app opens in your Shopify admin. Click **Get started**.

![Facebook & Instagram Get started page](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/get-started.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=715ff3d66996a625a9826108e6e2c4b8)

### Part 2: Connect your Meta account and create a catalog

**1. Connect your account**

Connect your Facebook profile and choose the business portfolio that owns your products. If you don't have one, click **Create new**.

![Connect business portfolio](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/connect-account.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=32d00651a7cab1bb92b7979a025b14c7)

**2. Create a catalog**

Expand the **Catalog** section and click **Create catalog**. This creates a Meta product catalog that your Shopify products will sync to.

![Create catalog in Meta](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/create-catalog.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=c2084b1819a92dac3e695cb62f379a4e)

**3. Choose data sharing preference**

Expand **Data sharing** and choose your preferred level (Conservative, Enhanced, or Maximum). This controls how customer activity data is shared with Meta. Click **Save**.

![Data sharing preference dialog](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/data-sharing.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=870ad4018117d0d1f031b3bc79076e5a)

**4. Submit for review**

Once all sections show a green checkmark (Facebook profile, Business portfolio, Catalog, Data sharing, Terms and conditions), click **Submit for review**.

![All sections complete, submit for review](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/submit-review.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=bdca43734e4a9c08f3a9fc077db7f195)

**5. Wait for setup to finalize**

The channel setup takes several minutes. Do not refresh the page. Once it finishes, the **Overview** tab appears.

![Finalizing channel setup progress bar](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/finalizing-setup.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=2dfb3f5ddf34c04f778eef9fd6581817)

### Part 3: Publish your products to the Meta catalog

**1. Click Publish products**

On the Facebook & Instagram **Overview** page, find the **Product Status** card and click **Publish products**. This opens the Shopify Products page.

![Product Status card with Publish products button](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/publish-products.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=504b7c6d19373fcf5690cc06b1baf71d)

**2. Select all products**

On the Products page, click the checkbox in the header row, then click **Select all results** to select every product in your store.

![Select all results in Shopify Products](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/select-all-products.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=d7755676f8653abb7afbf3f283f8ced7)

**3. Include in sales channels**

Click the **...** menu, then **Include in sales channels**. In the dialog that appears, check **Facebook & Instagram** and click **Include products**.

![Include in sales channels menu option](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/include-sales-channels.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=d496057740b4006995a4c91938991a08)

![Select Facebook & Instagram channel](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/select-fb-instagram-channel.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=d38ca0fb08fd05f7be0e04bf6e73ec7f)

**4. Verify products are syncing**

Go back to the Facebook & Instagram app in Shopify. Expand **Connected Product Catalog** to see your catalog details and confirm products are syncing.

![Connected Product Catalog section](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/connected-catalog.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=0ebbed402fba216ecc2ccea356f9a267)

You can also verify in [Meta Commerce Manager](https://business.facebook.com/commerce/) by navigating to your catalog's **Data sources** section. The product count should match your Shopify store.

![Commerce Manager showing synced products](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/commerce-manager-synced.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=03e6f740cf89b371b5e422e70a88fac1)

> [!WARNING]
>
> **Products showing 0 in Commerce Manager?** The initial sync can take a few minutes. If products still don't appear after waiting, go back to Shopify **Products**, select all products, click **...** > **Add tags**, add any tag (e.g. `sync-fix`), and save. Adding or removing a tag triggers Shopify to re-push the products to Meta. You can remove the tag afterwards.

![Commerce Manager showing 0 products](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/commerce-manager-zero.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=70fbf897d30784ec788a4f7657351aa5)

![Add tag dialog to trigger sync](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/add-tag-dialog.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=ba4e94afb9df86ab81f7eccdf1491603)

### Part 4: Assign Chatbase as a partner

Chatbase needs partner access to your Meta catalog to serve products through WhatsApp.

**1. Open Meta Business Settings**

Go to [Meta Business Settings](https://business.facebook.com/settings/) and navigate to **Data sources > Catalogues** in the left sidebar. Select your Shopify Product Catalog.

![Meta Business Settings Catalogues page](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/meta-catalogues.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=d2ddc58ddff3ae887fe674516aeca16b)

**2. Assign Chatbase as a partner**

Click **Assign partner**, choose **Business ID**, and enter Chatbase's Business ID:

```
918723022608702
```

Give **Partial access** and confirm.

![Assign partner dialog with Business ID option](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/assign-partner.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=71e42c9e83973da50b01697180ab4142)

### Part 5: Confirm the connection in Chatbase

**1. Open the Show Products Action**

In your [Chatbase dashboard](https://www.chatbase.co/dashboard/), go to **Build > Actions** and open the **Shopify get products** Action. Scroll down to the **WhatsApp Catalog** section. You'll see the setup steps listed for each WhatsApp Business Account (WABA). Click **Check now** or wait for it to refresh automatically.

![Chatbase WhatsApp Catalog section with setup steps](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/chatbase-catalog-steps.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=cb9c1bbc1f4b138ecf6bfc2648ec1624)

### Part 6: Connect the catalog in WhatsApp Manager

**1. Open WhatsApp Manager**

Once the partner assignment is detected, Chatbase shows a **Connect in WhatsApp Manager** button next to your WhatsApp number. Click it to open WhatsApp Manager.

![Chatbase showing Connect in WhatsApp Manager button](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/chatbase-connect-whatsapp.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=e2d84e8b959cd1aad7c085a860eedd07)

**2. Go to Catalogue**

In WhatsApp Manager, navigate to **Account tools > Catalogue** in the left sidebar. Make sure you are viewing the correct WhatsApp Business Account (WABA) in the top-right dropdown. Click **Choose a Catalogue**.

![WhatsApp Manager Catalogue page](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/whatsapp-manager-catalogue.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=8a68b8e9ec76abe315f8f0b9b73e2bce)

**3. Select and connect your catalog**

In the **Connect a catalogue** dialog, search for your Shopify Product Catalog, select it, and click **Connect Catalogue**.

![Connect a catalogue dialog with catalog selected](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/connect-catalogue-selected.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=ee50bb5f11761a9264dc6560fd8b9f0f)

**4. Catalogue connected**

You'll see a confirmation toast: **Catalogue successfully connected**. The page now shows your catalog details and options for showing the catalogue icon in the chat header and the "Add to basket" button.

![Catalogue successfully connected in WhatsApp Manager](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/catalogue-connected.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=b7a93f7a51c88d1795ba4d63b741f204)

### Part 7: Wait for Meta review

Return to the **Shopify get products** Action in Chatbase. The WhatsApp Catalog section now shows **In review** for your WhatsApp number. Meta reviews the products that were pushed from Shopify. This is part of Meta's standard review process and may take some time.

![Chatbase showing catalog In review status](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/chatbase-in-review.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=a89999b13fa1cfe2e8aaee8b4954d102)

Once Meta approves the catalog, the status changes to **Connected**. Your AI agent will now send native WhatsApp product cards with cart support when the Show Products Action is triggered.

![Chatbase showing catalog Connected status](https://mintcdn.com/chatbase/SshlV6jouna8lZa9/images/whatsapp-catalog/chatbase-connected.png?fit=max\&auto=format\&n=SshlV6jouna8lZa9\&q=85\&s=cd7257961ec15d5b5b66998b3f59b636)

> [!TIP]
>
> Test the integration by opening a WhatsApp conversation with your AI agent and asking to see products. The AI agent should respond with native product cards that customers can browse and add to a cart.

## How it works

Once connected, the **Retrieve and display products** Action automatically detects the WhatsApp channel and sends products as native WhatsApp catalog cards instead of plain text. Customers can:

* Browse product cards with images, titles, and prices
* Add items to a WhatsApp cart
* Send the cart to your AI agent to continue to checkout

### How the WhatsApp cart and the chat cart work together

Customers can fill their cart two ways: by tapping **Add to cart** on the catalog cards, or by asking the AI agent in chat (for example, "add two of these to my cart"), which uses the [Update cart](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#2-update-cart) Action. Both end up in the same Shopify cart, but they don't show up in the same places:

* **Items added in chat don't appear in the WhatsApp catalog cart.** WhatsApp's cart only exists on the customer's phone, and Meta doesn't let businesses add items to it. Items the AI agent adds are saved to the Shopify cart, not the WhatsApp cart.
* **Items from the WhatsApp cart reach the Shopify cart once the customer sends it.** Chatbase adds the items the customer sent to the same Shopify cart the AI agent uses. Sending the cart doesn't place an order by itself. The AI agent picks up from there, and the order is placed with [Create order](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#4-create-order).
* **"View my cart" shows everything.** When the customer asks to see their cart, the [Get cart](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#3-get-cart) Action lists every product in one place, whether it was added in chat or sent from the WhatsApp cart.

> [!TIP]
>
> Enable **Update cart**, **Get cart**, and **Create order** along with **Retrieve and display products** on your WhatsApp channel. Customers can then move between the catalog cards and the chat and still check out in one order.

### Example: a shopper buys on WhatsApp

Here's how a purchase runs once the catalog is **Connected** and the Actions in the tip above are on:

1. A shopper messages your WhatsApp number: "Do you have running shoes?" The AI agent uses **Retrieve and display products** and replies with WhatsApp product cards showing images, titles, and prices.
2. The shopper taps **Add to cart** on a pair of shoes. The item goes into their WhatsApp cart on their phone.
3. They type, "Add a pair of running socks too." The AI agent uses **Update cart** and adds the socks to the shopper's Shopify cart. The socks don't appear in the WhatsApp cart, because Meta doesn't let businesses add items to it.
4. The shopper sends their WhatsApp cart. Chatbase adds the shoes to the same Shopify cart. No order is placed yet.
5. They ask, "What's in my cart?" The AI agent uses **Get cart** and lists both the shoes and the socks in one place.
6. The shopper says, "Check out." The AI agent uses **Create order** to place one order for everything. With **Online payment**, the shopper gets a secure Shopify checkout link. See [Create order](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#4-create-order) for the payment options.

Product data stays in sync with your Shopify store through the Meta catalog. Changes in Shopify (price updates, new products, stock changes) sync to Meta automatically, though it may take a few minutes.

## Troubleshooting

> [accordion] Products show 0 in Meta Commerce Manager
>
> The initial sync from Shopify to Meta can take several minutes. If products still show 0 after waiting, go to **Shopify Admin > Products**, select all products, and use **... > Add tags** to add a temporary tag (e.g. `sync-fix`). This triggers Shopify to re-push the product data. You can remove the tag afterwards.

> [accordion] Catalog not appearing in WhatsApp Manager
>
> Make sure you assigned Chatbase as a partner (Business ID `918723022608702`) with **Partial access** in [Meta Business Settings > Catalogues](https://business.facebook.com/settings/). Also verify you are viewing the correct WhatsApp Business Account (WABA) in the WhatsApp Manager dropdown.

> [accordion] Status stuck on 'In review'
>
> Meta reviews catalog products before they can be served on WhatsApp. This is a standard Meta review process and is outside of Chatbase's control. Review times vary. Ensure your products comply with [Meta's commerce policies](https://www.facebook.com/policies/commerce/).

> [accordion] 'No catalog shared' still showing in Chatbase
>
> After assigning the partner in Meta Business Settings, return to the **Shopify get products** Action in Chatbase and click **Check now** to refresh the status. It may take a moment for Meta to propagate the partner assignment.

## Frequently asked questions

> [accordion] Do I need the Shopify integration to use WhatsApp Catalog?
>
> Yes. WhatsApp Catalog needs the [Shopify integration](https://chatbase.co/docs/user-guides/integrations/shopify.md), the [Retrieve and display products](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#1-retrieve-and-display-products) Action enabled, and a connected [WhatsApp channel](https://chatbase.co/docs/user-guides/integrations/whatsapp.md). Your products reach WhatsApp through a Meta catalog synced from Shopify.

> [accordion] Why don't items the AI agent added show up in the shopper's WhatsApp cart?
>
> WhatsApp's cart only exists on the shopper's phone, and Meta doesn't let businesses add items to it. Items the AI agent adds in chat go to the shopper's Shopify cart instead. When the shopper asks to see their cart, the AI agent lists everything with [Get cart](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#3-get-cart).

> [accordion] Does sending the WhatsApp cart place an order?
>
> No. Sending the cart adds its items to the shopper's Shopify cart. The AI agent continues the conversation, and the order is placed with [Create order](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#4-create-order).

> [accordion] Do shoppers pay inside WhatsApp?
>
> No. With **Online payment**, the AI agent sends a Shopify checkout link that opens in the shopper's browser, and the order is completed once they pay there. A [Create order](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#4-create-order) Action set to **Cash on delivery** or **Free order** places the order without a checkout link.

> [accordion] How quickly do price and stock changes reach WhatsApp?
>
> Changes you make in Shopify, such as price updates, new products, and stock changes, sync to the Meta catalog automatically. This can take a few minutes.

> [accordion] Can shoppers track their order on WhatsApp?
>
> Yes, with the [Retrieve and display orders](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#7-retrieve-and-display-orders) Action turned on for WhatsApp. Shoppers on WhatsApp aren't signed in to your store, so they verify the order with their checkout email or phone number plus the order number. See [Signed-in and guest customers](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#signed-in-and-guest-customers).

## Related

> [card] [Retrieve and display products](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#1-retrieve-and-display-products)
>
> Configure the Show Products Action that powers WhatsApp Catalog.

> [card] [WhatsApp integration](https://chatbase.co/docs/user-guides/integrations/whatsapp.md)
>
> Set up your WhatsApp channel connection.

> [card] [Shopify integration](https://chatbase.co/docs/user-guides/integrations/shopify.md)
>
> Connect your Shopify store to Chatbase.

> [card] [Meta Catalogs documentation](https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/catalogs-overview/)
>
> Official Meta documentation on WhatsApp catalogs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.