> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Coupon-code templates
> Let customers copy an offer code from a marketing message.
A coupon-code template is a marketing message with a button that copies a promotional code to the customer's clipboard.
Source: [Meta official example](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates/).
## Make the offer understandable
Include the benefit, where the code can be used, and the important conditions. For example:
> Save 15% on selected travel bags with code TRAVEL15. Valid through 30 September on orders over \$50. See eligible items and full terms on our offer page.
This is illustrative copy, not a claim that every promotion or product is eligible.
Decide whether the code is shared, single-use, or customer-specific. Your promotion system—not WhatsApp—enforces the minimum order, eligible products, redemption limit, and expiry.
## Configure the template
1. Select the intended WABA and a **Marketing** template.
2. Write the body and provide realistic examples for variables.
3. Add the supported copy-code button.
4. Add a destination or instructions explaining where to redeem the offer.
5. Submit and wait for approval.
The template defines the button and review example. The send request supplies the actual promotional code. If the body also displays the code, supply the same value in both places.
For API sending, the button uses subtype `copy_code` with a parameter of type `coupon_code`. This differs from the special OTP-button sending behavior of authentication templates.
Example of a **send-time button component only**:
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"type": "button",
"sub_type": "copy_code",
"index": 0,
"parameters": [
{ "type": "coupon_code", "coupon_code": "TRAVEL15" }
]
}
```
Use the button's actual zero-based position; `0` means the first button. This fragment does not include the required message envelope or any body parameters.
## Limits and client behavior
Meta's current coupon-template documentation specifies one copy-code button, a system-controlled button label, and a maximum of 20 characters for the example code. The YCloud OpenAPI field does not declare its own code-length maximum; if your editor applies a lower limit, use that supported limit and confirm any discrepancy before sending.
Meta also documents that this format is not supported in the WhatsApp web client. Test the phone experience; do not approve the design solely from a desktop conversation.
Use a short, unambiguous code. Avoid exposing account credentials, authentication codes, or personal information as promotional codes.
## Test redemption, not only copying
Check that the copied value matches the body, the offer page accepts it, eligible and ineligible baskets behave correctly, and expired or already-used codes are rejected appropriately.
Monitor message delivery and actual redemption separately. A copy-button interaction is not proof of a purchase.
Continue with [Marketing templates](/en/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates), [Manage templates](/en/api-reference/guides/whatsapp-platform/manage-whatsapp-templates), and [Send WhatsApp messages](/en/api-reference/guides/whatsapp-platform/send-whatsapp-message).
Source: [Meta coupon-code templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates/).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.