> For the complete documentation index, see [llms.txt](https://docs.chatalog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatalog.ai/e-commerce/coupon.md).
# Coupon
The Coupon feature allows you to create and distribute redeemable coupons directly through your chatbot flows. You can manage coupons from the E-commerce page and automatically send them to customers using the new **Distribute Coupon** flow block.
{% hint style="info" %}
This is an add-on feature. Please contact your account manager if you would like to enable it for your organization.
{% endhint %}
## Overview
With the Coupon feature, you can:
* Create and manage coupon campaigns
* Set coupon validity periods and redemption limits
* Customize the coupon redeem page
* Distribute coupons automatically through chatbot flows
* Track coupon redemption records
***
## Accessing the Coupon Feature
Go to: **E-commerce → Coupons**
From this page, you can:
* Create new coupons
* View existing coupons
* Check redemption records
* Configure the redeem page
***
## Create a Coupon
Click **Create Coupon** to add a new coupon.
### Required Fields
| Field | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Code | The coupon code customers will redeem. You can either let the system automatically generate the code or create a custom code manually. |
| Name | Coupon name |
| Active Period | Coupon validity period |
### Optional Fields
| Field | Description |
| ----------------------------- | ------------------------------------- |
| Overall Redemption Limit | Maximum total redemptions allowed |
| Per-customer Redemption Limit | Maximum redemption count per customer |
| Active | Enable or disable the coupon |
### Notes
* Coupons outside the active period cannot be redeemed.
* Disabled coupons cannot be distributed or redeemed.
* Redemption limits are checked automatically during redemption.
***
## Configure the Redeem Page
Each coupon can have a customizable redeem page shown to customers. You can click **View** on the list after creating a new one.
### Available Configurations
| Setting | Description |
| ------------------------------------------- | -------------------------------------------------------------- |
| Code on Page | Select how the coupon code is displayed |
| Redeem Button | Configure redeem button behavior |
| Button Label (When you set a redeem button) | Customize button text |
| Copy Code Button | Enable a copy coupon code button |
| Page Background | Customize background color |
| Brand Icon | Upload your brand logo |
| Campaign Image | Upload campaign banner/image |
| Terms and Conditions | Add the coupon usage rules, restrictions, and redemption terms |
### Redeem Page Preview
A mobile preview is available on the right side to help you review the customer experience before saving.
Click **Save Redeem Page** after configuration.
***
## Distribute Coupons in Flow Builder
You can automatically send coupons to customers using the new **Distribute Coupon** flow block.
### How to Use
1. Open **Flow Builder**
2. Add the **Distribute Coupon** block
3. Select a coupon
4. Configure the message content, button title, image URL, and fallback flows.
5. Connect with other flow blocks as needed
6. Save and publish the flow
### Configurable Content
| Field | Description |
| ---------------- | ------------------------------------------- |
| Coupon Selection | Choose which coupon to distribute |
| Message Content | Text message shown before coupon redemption |
| Button Title | Customize redeem button text |
| Image URL | Upload an image/banner |
***
## Flow Outcomes
The **Distribute Coupon** block supports different routing outcomes based on redemption results.
### Available Outcomes
| Outcome | Description |
| ------------------------- | ---------------------------------------------------------- |
| Coupon Expired | Triggered when the coupon validity period has ended |
| Customer Max Uses Reached | Triggered when the customer exceeds their redemption limit |
| Coupon Max Uses Reached | Triggered when the coupon reaches total redemption limit |
| Error | Triggered when redemption fails unexpectedly |
These outcomes can be connected to different follow-up flow blocks.
***
## View Redemption Records
You can monitor coupon usage from the redemption records page.
### Available Information
| Field | Description |
| ------------- | --------------------------- |
| Redemption ID | Unique redemption record ID |
| Customer ID | Customer identifier |
| Inbox ID | Inbox/channel identifier |
| Status | Redemption status |
| Redeemed At | Redemption timestamp |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.chatalog.ai/e-commerce/coupon.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.