# Marketing templates | Developer Documentation

<div id="bkmrk-marketing-templatesu">## Marketing templates

<div><span>Updated: Dec 5, 2025</span></div><div>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.</div><div id="bkmrk-custom-templates"><div id="bkmrk-custom-templates-1"><div>### Custom templates

</div></div></div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-ayog9wvu.png)</div><div>See our [custom marketing templates](/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.</div><div id="bkmrk-specialty-templates"><div id="bkmrk-specialty-templates-1"><div>### Specialty templates

</div></div></div><div>Some templates use a special component that requires or excludes additional components, or require additional configuration. These are described below.</div><div><div><div id="bkmrk-catalog-templates"><div id="bkmrk-catalog-templates-1"><div>#### Catalog templates

</div></div></div><div>[Catalog templates](/books/meta-whatsapp/page/catalog-templates-developer-documentation) are marketing templates that allow you to showcase your product catalog entirely within WhatsApp.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-fpnmwoax.png)</div></div><div><div id="bkmrk-coupon-code-template"><div id="bkmrk-coupon-code-template-1"><div>#### Coupon code templates

</div></div></div><div>[Coupon code templates](/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.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-mre3nwqo.png)</div></div><div><div id="bkmrk-media-card-carousel-"><div id="bkmrk-media-card-carousel--1"><div>#### Media card carousel templates

</div></div></div><div>[Media card carousel templates](/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.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-8dsjh6h0.png)</div></div><div><div id="bkmrk-call-permission-requ"><div id="bkmrk-call-permission-requ-1"><div>#### Call permission request templates

</div></div></div><div>[Call permission request templates](/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.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-5j3nx7ed.webp)</div></div><div><div id="bkmrk-limited-time-offer-t"><div id="bkmrk-limited-time-offer-t-1"><div>#### Limited-time offer templates

</div></div></div><div>[Limited-time offer templates](/books/meta-whatsapp/page/limited-time-offer-templates-developer-documentation) 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.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-ytwyz8cl.png)</div></div><div><div id="bkmrk-multi-product-messag"><div id="bkmrk-multi-product-messag-1"><div>#### Multi-product message templates

</div></div></div><div>[Multi-product message templates](/books/meta-whatsapp/page/multi-product-message-templates-developer-documentation) allow you to showcase up to 30 products from your ecommerce catalog, organized in up to 10 sections, in a single message.</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-fwq2d7cp.png)</div></div><div><div id="bkmrk-product-card-carouse"><div id="bkmrk-product-card-carouse-1"><div>#### Product card carousel templates

</div></div></div><div>[Product card carousel templates](/books/meta-whatsapp/page/product-card-carousel-templates-developer-documentation) allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view:</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-mhcl2ufc.png)</div></div><div><div id="bkmrk-single-product-messa"><div id="bkmrk-single-product-messa-1"><div>#### Single-product message templates

</div></div></div><div>[Single-product message templates](/books/meta-whatsapp/page/single-product-message-templates-developer-documentation) allow you to send a single text message accompanied by a set of up to 10 product cards in a horizontally scrollable view:</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-jbhgukiz.png)</div></div></div><div id="bkmrk-per-user-marketing-t"><div id="bkmrk-per-user-marketing-t-1"><div>### Per-user marketing template message limits

</div></div></div><div>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.</div><div>Refer to [per-user marketing template message limits](/books/meta-whatsapp/page/per-user-marketing-template-message-limits-developer-documentation) document for more information.</div><div id="bkmrk-user-preferences-for"><div id="bkmrk-user-preferences-for-1"><div>### User preferences for marketing messages

</div></div></div><div>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.</div><div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-esawokvd.png)</div></div><div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-iwhyge04.png)</div></div></div><div id="bkmrk-interested%2Fnot-inter"><div id="bkmrk-interested%2Fnot-inter-1"><div>#### Interested/Not Interested feedback

</div></div></div><div>WhatsApp users can use the **Offers and announcements** setting to indicate how interested they are in receiving marketing template messages from your business.</div><div>If a user chooses **Not interested**, it can affect [per-user marketing template messaging limits](/books/meta-whatsapp/page/per-user-marketing-template-message-limits-developer-documentation) 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.</div><div id="bkmrk-stop%2Fresume-controls"><div id="bkmrk-stop%2Fresume-controls-1"><div>#### Stop/Resume controls

</div></div></div><div>WhatsApp users can use the **Offers and announcements** setting to stop or resume delivery of marketing template messages from your business.</div><div>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](/books/meta-whatsapp/page/status-messages-webhook-reference-developer-documentation) with:</div><span>`status` set to `failed`,</span><span>`code` set to `131050`,</span><span>`title` set to </span>```
Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business
```

<div>To be notified whenever a WhatsApp user stops or resumes delivery of marketing template messages from your business, subscribe to the [user\_preferences webhook](/books/meta-whatsapp/page/user-preferences-webhook-reference-developer-documentation) webhook.</div><div id="bkmrk-for-accounts-linked-"><div id="bkmrk-for-accounts-linked--1"><div>### For accounts linked with WhatsApp Business app (aka “Coexistence”)

</div></div></div><div>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.</div><div>Note: This feature is currently limited and not generally available (GA) to all users.</div></div>