Multi-Product Templates

Multi-product templates let you send a curated selection of products from your WhatsApp Commerce catalog. When the user taps the button, they see a product list organized into sections that they can browse and add to cart directly within WhatsApp.

Prerequisites

Before creating multi-product templates, you must:

Set up commerce messaging on your WhatsApp channel -- connect a Facebook catalog to your WhatsApp Business Account. Follow the guide: Set up commerce messaging.
Get your product IDs from the connected catalog in Facebook Commerce Manager. Open your catalog and copy the content IDs of the products you want to feature. These IDs are used as externalProductId values in the template.

A catalog can only be associated with one WhatsApp Business Account at a time, and a WhatsApp Business Account can only be connected to one catalog. The product IDs must come from the catalog connected to the WhatsApp channel you will send the message from.

Block Structure

A multi-product template uses a single whatsapp-multi-product block:

Component	Required	Description
Header	Yes	Text, image, or file header
Body text	Yes	Main message text (max 1024 characters)
Footer text	No	Text below the body (max 60 characters)
Multi-product action	Yes	Button that opens the product selection view

Header

Multi-product templates require a header, which can be text, image, or file.

Text header:

Codebeispiel

{
  "type": "text",
  "text": {
    "text": "Our Top Picks"
  }
}

Image header:

Codebeispiel

{
  "type": "image",
  "image": {
    "mediaUrl": "https://example.com/images/deals-banner.jpg"
  }
}

If you need to host media, use the Media Library API to upload files and get a mediaUrl. See Image Template Blocks -- Uploading media for the full upload flow.

Body

The body is mandatory and describes the product selection.

Codebeispiel

{
  "type": "text",
  "text": {
    "text": "We've curated a selection of products just for you. Tap below to browse and shop!"
  }
}

Footer

Optional text footer, max 60 characters.

Codebeispiel

{
  "type": "text",
  "text": {
    "text": "Free delivery on orders over $30"
  }
}

Multi-Product Action

The multi-product action creates a "View products" button. Products can be organized as a flat list or grouped into sections.

With product sections (static)

Products organized into named sections:

Codebeispiel

{
  "type": "multi-product-action",
  "multiProductAction": {
    "parameterKey": "products",
    "thumbnailExternalProductId": "SKU-001",
    "productSections": [
      {
        "type": "whatsapp-product-section",
        "whatsappProductSection": {
          "title": "Best Sellers",
          "products": [
            {
              "type": "whatsapp-product-item",
              "whatsappProductItem": {
                "externalProductId": "SKU-001"
              }
            },
            {
              "type": "whatsapp-product-item",
              "whatsappProductItem": {
                "externalProductId": "SKU-002"
              }
            }
          ]
        }
      },
      {
        "type": "whatsapp-product-section",
        "whatsappProductSection": {
          "title": "New Arrivals",
          "products": [
            {
              "type": "whatsapp-product-item",
              "whatsappProductItem": {
                "externalProductId": "SKU-003"
              }
            },
            {
              "type": "whatsapp-product-item",
              "whatsappProductItem": {
                "externalProductId": "SKU-004"
              }
            }
          ]
        }
      }
    ]
  }
}

With a flat product list

Products as a simple list without sections:

Codebeispiel

{
  "type": "multi-product-action",
  "multiProductAction": {
    "parameterKey": "products",
    "productList": [
      {
        "type": "whatsapp-product-item",
        "whatsappProductItem": {
          "externalProductId": "SKU-001"
        }
      },
      {
        "type": "whatsapp-product-item",
        "whatsappProductItem": {
          "externalProductId": "SKU-002"
        }
      },
      {
        "type": "whatsapp-product-item",
        "whatsappProductItem": {
          "externalProductId": "SKU-003"
        }
      }
    ]
  }
}

Property	Required	Description
parameterKey	Yes	Variable key for dynamic product data
thumbnailExternalProductId	No	Product ID to use as the button thumbnail
productSections	No	Products organized into named sections (1--10 sections)
productList	No	Flat list of products (1--30 products)

Use either productSections or productList, not both. Sections support 1--10 sections with 1--30 products each.

Complete Example

Codebeispiel

{
  "defaultLocale": "en",
  "deployments": [
    {
      "key": "whatsappTemplateName",
      "platform": "whatsapp",
      "value": "weekly_deals"
    },
    {
      "key": "whatsappCategory",
      "platform": "whatsapp",
      "value": "MARKETING"
    },
    {
      "key": "whatsappAllowCategoryChange",
      "platform": "whatsapp",
      "value": "true"
    }
  ],
  "variables": [
    {
      "key": "products",
      "description": "Product list for multi-product message",
      "type": "whatsappProductSections",
      "format": "none",
      "examplesLocale": {
        "en": {
          "exampleValues": [
            {
              "sections": [
                {
                  "type": "whatsapp-product-section",
                  "whatsappProductSection": {
                    "title": "Deals",
                    "products": [
                      {
                        "type": "whatsapp-product-item",
                        "whatsappProductItem": {
                          "externalProductId": "SKU-001"
                        }
                      }
                    ]
                  }
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "platformContent": [
    {
      "locale": "en",
      "type": "text",
      "platform": "whatsapp",
      "channelGroupIds": [
        "3f979241-dea3-4f55-b7bb-d769eec27e51"
      ],
      "blocks": [
        {
          "type": "whatsapp-multi-product",
          "whatsappMultiProduct": {
            "header": {
              "type": "text",
              "text": {
                "text": "This Week's Deals"
              }
            },
            "body": {
              "type": "text",
              "text": {
                "text": "Check out our handpicked deals for this week! Browse by category and add items to your cart."
              }
            },
            "footer": {
              "type": "text",
              "text": {
                "text": "Deals expire Sunday midnight"
              }
            },
            "action": {
              "type": "multi-product-action",
              "multiProductAction": {
                "parameterKey": "products",
                "thumbnailExternalProductId": "SKU-001",
                "productSections": [
                  {
                    "type": "whatsapp-product-section",
                    "whatsappProductSection": {
                      "title": "Electronics",
                      "products": [
                        {
                          "type": "whatsapp-product-item",
                          "whatsappProductItem": {
                            "externalProductId": "SKU-001"
                          }
                        },
                        {
                          "type": "whatsapp-product-item",
                          "whatsappProductItem": {
                            "externalProductId": "SKU-002"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "type": "whatsapp-product-section",
                    "whatsappProductSection": {
                      "title": "Accessories",
                      "products": [
                        {
                          "type": "whatsapp-product-item",
                          "whatsappProductItem": {
                            "externalProductId": "SKU-010"
                          }
                        },
                        {
                          "type": "whatsapp-product-item",
                          "whatsappProductItem": {
                            "externalProductId": "SKU-011"
                          }
                        },
                        {
                          "type": "whatsapp-product-item",
                          "whatsappProductItem": {
                            "externalProductId": "SKU-012"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        }
      ]
    }
  ],
  "supportedPlatforms": ["whatsapp"]
}

Constraints

Rule	Limit
Product sections	1--10
Products per section	1--30
Products (flat list)	1--30
Header type	Text, image, or file

Catalog Template Blocks -- Open the full catalog
Carousel Template Blocks -- Scrollable cards with images
Creating WhatsApp Message Templates -- Full template creation workflow