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

# Marketing templates

# Marketing templates

Updated: Dec 5, 2025

Marketing templates are typically used to drive engagement, brand awareness, and driving sales.
They are the only type of template that can be used with both Cloud API and Marketing Messages API for WhatsApp.

## Custom templates

You can use the [POST /\<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>/message\_templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api#Creating) endpoint to create custom marketing templates that suit your business needs from any supported components.

![](https://scontent-fra5-1.xx.fbcdn.net/v/t39.2365-6/555677225_1191798406305539_8221742988743767334_n.png?_nc_cat=102\&ccb=1-7&_nc_sid=e280be&_nc_ohc=ohYAa3WTEVgQ7kNvwGOGoUJ&_nc_oc=AdmcdoazqXqmN7B7ZAe_P3TkcL3XCtY87veeApSyd_Q0xEpKSfTn4MCIhc8iCLyBnOc&_nc_zt=14&_nc_ht=scontent-fra5-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfmCdv4QRl9oTOq5pEB2_j_uYbTAtxAj-wiL60abzAUY_w\&oe=69551A23)

See our [custom marketing templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/custom-marketing-templates) document for example of how to create and send a custom template, and which components are supported.

## Specialty templates

Some templates use a special component that requires or excludes additional components, or require additional configuration. These are described below.

### Catalog templates

[Catalog templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/catalog-templates) are marketing templates that allow you to showcase your product catalog entirely within WhatsApp.

![](https://scontent-fra3-1.xx.fbcdn.net/v/t39.2365-6/354047426_125269187252102_7173148343631613735_n.png?_nc_cat=105\&ccb=1-7&_nc_sid=e280be&_nc_ohc=84GMpH9sAbEQ7kNvwGiaKnJ&_nc_oc=AdmjFRyny15BbDMd_Ckts5nGBmo2kh4XQbTNcF4JxtRlsJ8CIJKuYCC1c1TO2_QNGdQ&_nc_zt=14&_nc_ht=scontent-fra3-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfmS2Yp1_waM62HgH9M3u-yWSUOUjLJZyw9SLm9QCKuslQ\&oe=695539E6)

### Coupon code templates

[Coupon code templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates) are marketing templates that display a single copy code button. When tapped, the code is copied to the customer’s clipboard.

![](https://scontent-fra5-2.xx.fbcdn.net/v/t39.2365-6/365756533_1756280054770140_7287687181799037425_n.png?_nc_cat=107\&ccb=1-7&_nc_sid=e280be&_nc_ohc=rH4JPp7fqRkQ7kNvwF1uNfG&_nc_oc=AdnFUQCR4qmb1Tonjh7Q_qUOTgTucZDye0yYv8gWxrfotb3vIRpb44Wxj0kEPVBliPo&_nc_zt=14&_nc_ht=scontent-fra5-2.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfnJoafodzo3FmxkC50-wsW0gYgU-gesqGRLHgKo0LMaxQ\&oe=695521A5)

### Media card carousel templates

[Media card carousel templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates) allow you to send a single text message accompanied by a set of up to 10 media cards in a horizontally scrollable view.

![](https://scontent-fra5-2.xx.fbcdn.net/v/t39.2365-6/461961248_1048610163180196_3907313698557856900_n.png?_nc_cat=107\&ccb=1-7&_nc_sid=e280be&_nc_ohc=lKkI7MnrIAEQ7kNvwFdiCCd&_nc_oc=AdlsqQDOFYc3PH5Ud7YNzXtqtohT1CHL5yDraR5-ARxr2TH1bS1LbG6yTZxxXh5tLdc&_nc_zt=14&_nc_ht=scontent-fra5-2.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_Afn_WeJ-1u3gWS9_OkGaQwT_NysytHQnnMdGjojJgVmVlg\&oe=695522BC)

### Call permission request templates

[Call permission request templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/call-permission-request-message-template) allow your business to call your customers outside of the customer service window.

![](https://scontent-fra5-1.xx.fbcdn.net/v/t39.2365-6/556555685_1517571612922347_1402127790412272783_n.webp?_nc_cat=102\&ccb=1-7&_nc_sid=e280be&_nc_ohc=43-i7MYvFQ0Q7kNvwHvblgI&_nc_oc=Adlg_lnH0yLZ44dmoo_nKvB9mR_eQQvN1--LGMTHzfPrazTujptIbZC2167Sxl4A1fI&_nc_zt=14&_nc_ht=scontent-fra5-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfmCNzGqiDX2sk754OCwvfhqZH1JzCaBEpPz7XpB9b4oog\&oe=69551FDA)

### Limited-time offer templates

[Limited-time offer templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/limited-time-offer-templates) allow you to display expiration dates and running countdown timers for offer codes in template messages, making it easy for you to communicate time-bound offers and drive customer engagement.

![](https://scontent-fra5-1.xx.fbcdn.net/v/t39.2365-6/385485492_1044097420371007_6435130166952753459_n.png?_nc_cat=110\&ccb=1-7&_nc_sid=e280be&_nc_ohc=t21u8W3K_Y0Q7kNvwGhwb_w&_nc_oc=Adm1zCmjrj2W2pmuLApJ95ChoXtEeuCgmGslT4r_a0ftYf0UhE0sQKmpYtZtQ5ygsiI&_nc_zt=14&_nc_ht=scontent-fra5-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfkTJLjAIiuk1PITAAzDF2ie7ZvSYmS_-3zrmY0Lu_DxPg\&oe=695533FF)

### Multi-product message templates

[Multi-product message templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/mpm-templates) allow you to showcase up to 30 products from your ecommerce catalog, organized in up to 10 sections, in a single message.

![](https://scontent-fra3-1.xx.fbcdn.net/v/t39.2365-6/345336924_1476472873159435_9050004394387774321_n.png?_nc_cat=105\&ccb=1-7&_nc_sid=e280be&_nc_ohc=9qNRIRewfisQ7kNvwELU76T&_nc_oc=AdkkaP5GwJOHdSRM9yAYvBS2_51alEeXCrlWATJJCCOFcphqGPtkXMqCy9BnrmDhkts&_nc_zt=14&_nc_ht=scontent-fra3-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_Afnz1Wdxr7BqFLYVBYoTDWZmZtPJ_m2K9bL1hlG_T7dxyg\&oe=6955255C)

### Product card carousel templates

[Product card carousel templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/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:

![](https://scontent-fra3-1.xx.fbcdn.net/v/t39.2365-6/456451243_832660229062364_6760679807399209749_n.png?_nc_cat=108\&ccb=1-7&_nc_sid=e280be&_nc_ohc=O75ePXKxH18Q7kNvwGpchGX&_nc_oc=AdnHTuCs4aYXzv3LlZo0L73tM8s3bppC9pueH5QnG1u2rJcNrXpmEhnPLxwkuLYSG9w&_nc_zt=14&_nc_ht=scontent-fra3-1.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_Afm9rqpXkucryJAmAcgVQ-v-mNPeg3fmkIjO7EUn_X_URg\&oe=695509A3)

### Single-product message templates

[Single-product message templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/spm-templates) allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view:

![](https://scontent-fra3-2.xx.fbcdn.net/v/t39.2365-6/456611074_369667709517740_8197750041061962345_n.png?_nc_cat=111\&ccb=1-7&_nc_sid=e280be&_nc_ohc=KlMC8d63RlkQ7kNvwFRcuJ_&_nc_oc=Adnvn2jYJmAy55PAR0n7pdphgPcTOuiBJ6jTF8GMhXOCpzILkooVvGYwuQVf0tGutKY&_nc_zt=14&_nc_ht=scontent-fra3-2.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfnAPWvXP0wGXN-gUiueZ7R39xWf2Le8TAhxB12LJe2SLg\&oe=6955334A)

## Per-user marketing template message limits

WhatsApp may limit the number of marketing template messages a person receives from any business in a given period of time, starting with delivering fewer marketing conversations to those users who are less likely to engage with them. In most WhatsApp markets, this is determined based on a number of factors, including a dynamic view of an individual’s marketing message read rate.

Refer to [per-user marketing template message limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) document for more information.

## User preferences for marketing messages

WhatsApp provides a setting, **Offers and announcements**, that allows WhatsApp users to indicate their interest level in marketing messages sent from your business, and to stop or resume delivery of marketing messages from your business entirely.

![](https://scontent-fra5-2.xx.fbcdn.net/v/t39.2365-6/499661558_686750450817076_8407823728923343264_n.png?_nc_cat=107\&ccb=1-7&_nc_sid=e280be&_nc_ohc=pfU2GtoUjTMQ7kNvwGJVy0g&_nc_oc=AdlbolKPuxdUrEf5Pk-Bii5D_WPO9hMHmdvQs3NuihDzWAz8CNoxikItNGIWxu4i2HU&_nc_zt=14&_nc_ht=scontent-fra5-2.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AflGCV3vUgBvLh1KQ1ILaEeHvusLWcKkqp3_WBCPrbmKCA\&oe=69551BB8)

![](https://scontent-fra3-2.xx.fbcdn.net/v/t39.2365-6/497928479_674388312073388_4498328545588580050_n.png?_nc_cat=104\&ccb=1-7&_nc_sid=e280be&_nc_ohc=ZnStUAlSFJsQ7kNvwFF5nX8&_nc_oc=Adm8EAdRpFss9w6AX7DxStFMHzLCjknZpvC4C9K8C3BTb8qtbDQh1XAMNpECOKicXNo&_nc_zt=14&_nc_ht=scontent-fra3-2.xx&_nc_gid=-QWIfzVIsWylSS32ge-fJw\&oh=00_AfmMXJVeTvo7Oh1uqdd0uOUxvBW_bR5J5rqUQBkuYbjJJQ\&oe=6955110D)

### Interested/Not Interested feedback

WhatsApp users can use the **Offers and announcements** setting to indicate how interested they are in receiving marketing template messages from your business.

If a user chooses **Not interested**, it can affect [per-user marketing template messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) between you and the user. Choosing this option also displays the second modal, which gives the user the option to stop delivery of marketing messages from your business.

### Stop/Resume controls

WhatsApp users can use the **Offers and announcements** setting to stop or resume delivery of marketing template messages from your business.

If you attempt to send a marketing template to a WhatsApp user who has stopped marketing template messages from your business, the API will process the request but not send the message. Instead, the API will trigger a [status messages webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) with:

`status` set to `failed`,
`code` set to `131050`,
`title` set to `Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business`

To be notified whenever a WhatsApp user stops or resumes delivery of marketing template messages from your business, subscribe to the [user\_preferences webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences) webhook.

## For accounts linked with WhatsApp Business app (aka “Coexistence”)

To improve the experience for WhatsApp Business Users, marketing messages sent to business customers will not bump chat threads to the top of the inbox. These messages will still be delivered and visible to business customers, but the thread will only move to the top if the customer responds.

Note: This feature is currently limited and not generally available (GA) to all users.

Did you find this page helpful?

![Thumbs up icon](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)

![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

ON THIS PAGE

Custom templates

Specialty templates

Catalog templates

Coupon code templates

Media card carousel templates

Call permission request templates

Limited-time offer templates

Multi-product message templates

Product card carousel templates

Single-product message templates

Per-user marketing template message limits

User preferences for marketing messages

Interested/Not Interested feedback

Stop/Resume controls

For accounts linked with WhatsApp Business app (aka “Coexistence”)

***