Catalog templates

Updated: Nov 14, 2025 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 Syntax

Use the WhatsApp Business Account > Message Templates endpoint to create a catalog template. Once your template is approved, you can use Cloud API to send it in a template message.

curl -X POST "https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;WHATSAPP_BUSINESS_ACCOUNT_ID&gt;/message_templates" \
  -H "Authorization: Bearer &lt;ACCESS_TOKEN&gt;" \
  -H "Content-Type: application/json" \
  -d '
\{
    "name": "&lt;NAME&gt;",
    "language": "&lt;LANGUAGE&gt;",
    "category": "MARKETING",
    "components": [\
      {\
        "type": "BODY",\
        "text": "&lt;BODY_TEXT&gt;",\
        "example": {\
          "body_text": [\
            [\
              "&lt;EXAMPLE_BODY_TEXT&gt;"\
            ]\
          ]\
        }\
      },\
      {\
        "type": "FOOTER",\
        "text": "&lt;FOOTER_TEXT&gt;"\
      },\
      {\
        "type": "BUTTONS",\
        "buttons": [\
          {\
            "type": "CATALOG",\
            "text": "View catalog"\
          }\
        ]\
      }\
    ]
  }'

Request parameters

Placeholder	Description	Sample Value
`<BODY_TEXT>` 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!`
`<EXAMPLE_BODY_TEXT>` String (of an array of strings)	Required if body text uses variables. Sample strings to replace variable placeholders in `<BODY_TEXT>` string. Maximum 1024 characters.	`100`
`<FOOTER_TEXT>` String	Optional. Template footer text. Variables are supported. Maximum 60 characters.	`Best grocery deals on WhatsApp!`
`<LANGUAGE>` String	Required. Template language and locale code.	`en_US`
`<NAME>` String	Required. Template name. Maximum 512 characters.	`intro_catalog_offer`

Example request

curl 'https://graph.facebook.com/v17.0/102290129340398/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "name": "intro_catalog_offer",
  "language": "en_US",
  "category": "MARKETING",
  "components": [\
    {\
      "type": "BODY",\
      "text": "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!",\
      "example": {\
        "body_text": [\
          [\
            "100",\
            "400",\
            "3"\
          ]\
        ]\
      }\
    },\
    {\
      "type": "FOOTER",\
      "text": "Best grocery deals on WhatsApp!"\
    },\
    {\
      "type": "BUTTONS",\
      "buttons": [\
        {\
          "type": "CATALOG",\
          "text": "View catalog"\
        }\
      ]\
    }\
  ]
}'

Example response

\{
  "id": "546151681022936",
  "status": "PENDING",
  "category": "MARKETING"
}

Sending catalog template messages

This document explains how to 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 syntax

Use the WhatsApp Business Phone Number > Messages endpoint to send a catalog template message using a catalog template with an APPROVED status.

curl -X POST "https://graph.facebook.com/v19.0/&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;/messages" \
  -H "Authorization: Bearer &lt;ACCESS_TOKEN&gt;" \
  -H "Content-Type: application/json" \
  -d '
\{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "&lt;TO&gt;",
    "type": "template",
    "template": {
      "name": "&lt;NAME&gt;",
      "language": {
        "code": "&lt;CODE&gt;"
      },
      "components": [\
        {\
          "type": "body",\
          "parameters": [\
            {\
              "type": "&lt;TYPE&gt;",\
              "text": "&lt;TEXT&gt;"\
            }\
          ]\
        },\
        {\
          "type": "button",\
          "sub_type": "CATALOG",\
          "index": 0,\
          "parameters": [\
            {\
              "type": "action",\
              "action": {\
                "thumbnail_product_retailer_id": "&lt;THUMBNAIL_PRODUCT_RETAILER_ID&gt;"\
              }\
            }\
          ]\
        }\
      ]
    }
  }'

Request parameters

Placeholder	Description	Sample Value
`<CODE>` String	Required. Template language and locale code.	`en_US`
`<NAME>` String	Required. Template name.	`intro_catalog_offer`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` 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`
`<TEXT>` String	Required if template uses variables. Template variable.	`100`
`<TO>` String	Required. Customer phone number.	`+16505551234`
`<TYPE>` String	Required if template uses variables. Template variable type.	`text`

Example request

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "template",
  "template": {
    "name": "intro_catalog_offer",
    "language": {
      "code": "en_US"
    },
    "components": [\
      {\
        "type": "body",\
        "parameters": [\
          {\
            "type": "text",\
            "text": "100"\
          },\
          {\
            "type": "text",\
            "text": "400"\
          },\
          {\
            "type": "text",\
            "text": "3"\
          }\
        ]\
      },\
      {\
        "type": "button",\
        "sub_type": "CATALOG",\
        "index": 0,\
        "parameters": [\
          {\
            "type": "action",\
            "action": {\
              "thumbnail_product_retailer_id": "2lc20305pt"\
            }\
          }\
        ]\
      }\
    ]
  }
}'

Example response

\{
  "messaging_product": "whatsapp",
  "contacts": [\
    {\
      "input": "+16505551234",\
      "wa_id": "16505551234"\
    }\
  ],
  "messages": [\
    {\
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI5RkEwM0EyODFEQzQ2NDYzQTMA"\
    }\
  ]
}

Overview

Getting started

Business setup

Messages

Templates

Embedded signup

Flows

Calling

Groups

Payments

Catalogs

Marketing messages

Click to WhatsApp ads

Solution providers

API reference

Pricing

Policies

Other

Support

Catalog templates

Catalog templates

Creating catalog templates

Requirements

Request Syntax

Request parameters

Example request

Example response

Sending catalog template messages

Requirements

Request syntax

Request parameters

Example request

Example response

See also

​Catalog templates

​Creating catalog templates

​Requirements

​Request Syntax

​Request parameters

​Example request

​Example response

​Sending catalog template messages

​Requirements

​Request syntax

​Request parameters

​Example request

​Example response

​See also

Catalog templates

Creating catalog templates

Requirements

Request Syntax

Request parameters

Example request

Example response

Sending catalog template messages

Requirements

Request syntax

Request parameters

Example request

Example response

See also