---
title: "Coupons policies"
slug: "coupons-policies"
abstract: ""
---
# Coupons policies

The Commerce Engine encompasses extensible services that enable you to customize commerce functionality.

> [!note]
> Do not extend or inherit from out-of-the-box policies; instead, create your own. You can change the values in a policy by modifying the PolicySet JSON or the Environment JSON, depending on where the policy is defined and then re-running Bootstrap.

The following policies can be configured through the Coupons plug-in.

| Policy | Description | Properties / Default Values |
| --- | --- | --- |
| `GlobalCouponsPolicy` | Defines global settings for coupons.<br><br><ul><li>`GeneratedCouponCodeLength` – defines number of characters that the coupon code can have.</li><li>`MaxCouponCodeLength` – maximum length of a coupon before it is rejected though validation; default = 30 (integer).</li><li>`MaxCouponPrefixLength` – maximum length of the coupon’s prefix; default = 10 (integer).</li><li>`MaxCouponSuffixLength` – maximum length of the coupon’s suffix; default = 10 (integer).</li><li>`MaxNumberOfPrivateCoupons` – maximum number of coupons to generate at one time; default = 1000 (integer).</li><li>`MinPrivateCouponTotal` – minimum number of private coupons; default = 1 (integer).</li><li>`MinAllocationCount` – minimum number of coupons to allocate; default = 1 (integer).</li></ul> | MaxCouponCodeLength \ 30<br><br>MaxCouponPrefixLength \ 10<br><br>MaxCouponSuffixLength \ 10<br><br>GeneratedCouponCodeLength  \ 6<br><br>MaxNumberOfPrivateCoupons \ 1000<br><br>MinPrivateCouponTotal \ 1<br><br>MinAllocationCount \ 1 |
| `KnownCouponActionsPolicy` | Defines the names of the coupon entity view actions. | AddCoupon \ "AddCoupon"<br><br>RemoveCoupon \ "RemoveCoupon"<br><br>AddPrivateCoupon \ "AddPrivateCoupon"<br><br>AddPublicCoupon \ "AddPublicCoupon"<br><br>NewAllocation \ "NewAllocation" DownloadCouponCodes \ "DownloadCouponCodes" |
| `KnownCouponsListsPolicy` | Defines the names of the coupons transient and entity index lists. | PromotionCoupons \ "Promotions-{0}-Coupons"<br><br>AllocatedCoupons \ "Promotion-{0}-AllocatedCoupons"<br><br>UnallocatedCoupons \ "Promotion-{0}-UnallocatedCoupons"<br><br>PublicCoupons \ "Promotion-{0}-PublicCoupons"<br><br>PrivateCouponGroups \ "Promotion-{0}-PrivateCouponGroups" |
| `KnownCouponViewsPolicy` | Defines the names of the coupons entity views. | PublicCoupons \ "PublicCoupons"<br><br>PrivateCoupons \ "PrivateCoupons"<br><br>CouponDetails \ "CouponDetails"<br><br>Coupons \ "Coupons"<br><br>AllocationDetails \ "AllocationDetails"<br><br>Allocations \ "Allocations" |
| `LimitUsagesPolicy` | Defines how many times a coupon can be use. | LimitCount \ 1 |
| `CartCouponsPolicy` | Defines a policy for the `CartCoupons `component:<br><br><ul><li>`MaxCouponsInCart `– maximum # of coupons allowed in the cart; default = 5 (integer).</li></ul> |  |