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

# Discounts

> Create coupons and promotional codes

You can manage all your coupons from the **Product Catalog**.

Navigate to **Product Catalog > Discounts** to see a list of every active and expired code.

You can create two types of discounts:

* **Percentage** — Reduces an eligible price by a percentage, such as 20%.
* **Fixed amount** — Subtracts a specific amount in a selected currency, such as USD 10 or INR 500.

For a fixed-amount discount, select the currency next to the amount. Kelviq places the currency from your organization profile first in the list, but you should still review the selection before creating the discount.

## Create a discount

**1. Start creation**

Click **+ Create discount** in the top right corner.

**2. Define value**

Choose the discount type (Percentage or Fixed amount) and enter the value.

* **Name:** The internal name for your reference.
* **Discount code:** The text the customer enters at checkout. You can type your own or click the **refresh icon** to auto-generate a secure random code.

**3. Configure rules**

Set the duration, limits, and product scope (detailed below).

**4. Create**

Click **Create discount** to make the code live immediately.

![Discount creation modal showing percentage and code options](https://mintcdn.com/kelviq/Wc9yxdorrRWmfWkJ/images/create-discount-modal.webp?fit=max\&auto=format\&n=Wc9yxdorrRWmfWkJ\&q=85\&s=b9d963a5607b310fb22ffb6e64f2b33b)

## Configuration options

You can control exactly how and when a discount applies.

### Duration

Recurring discount settings are enabled by default. Choose how long the discount should apply:

* Enter a number of billing cycles for a limited recurring discount.
* Select **Discount applies forever** to apply it to every eligible recurring invoice.
* Turn off **Recurring discount** when the code should apply only to the initial purchase.

### Usage & expiry

Control the scarcity of the coupon.

* **Redemption limit:** Set a total number of times this code can be used (e.g. "First 100 users").
* **Expiry date:** Set a hard deadline when the code stops working.

### Product restrictions

By default, a discount applies to the entire catalog. To restrict it:

1. Enable **Limit discount to selected products**.
2. Select a product in every restriction row you add.
3. Optionally select a specific plan price. Choose **Applies to all plans** to include every price under that product.

Kelviq will not create the discount while a restriction row has no product selected.

For fixed-amount discounts, the discount currency must match the currency of the selected price. Kelviq shows a validation error when the currencies do not match.

## Apply a discount at checkout

Customers can enter a code themselves, or you can pre-apply one through the Checkout API or a static checkout link. See [Apply a discount code at checkout](https://docs.kelviq.com/checkout/apply-a-discount-code.md) for working examples and field names.

## Management

The main discounts tab shows the status of every code you have created.

![List of active and expired discounts](https://mintcdn.com/kelviq/JmP2EJbLzkBV0n72/images/discounts-list.webp?fit=max\&auto=format\&n=JmP2EJbLzkBV0n72\&q=85\&s=45202aa6c1aea1d27b3fbc4abe9d91e2)

* **Active:** The code is live and redeemable.
* **Expired:** The code has passed its end date or hit its usage limit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.