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

# Create discounts and coupon codes for your store

> Build percentage, fixed-amount, and free-shipping promotions using manual coupon codes or automatic cart rules with scopes, limits, and date ranges.

Cartble's discount engine lets you run targeted promotions without a third-party app. You can create coupon codes that customers enter at checkout, or define automatic promotions that apply silently the moment a customer's cart qualifies. Every discount rule is fully configurable — from the type of value it applies, to which products it covers, to how many times it can be used before it expires.

## Discount methods

Every discount rule uses one of two methods to reach the customer's cart.

<CardGroup cols={2}>
  <Card title="Manual Coupon" icon="tag">
    You generate a code (e.g., `VIP20` or `SUMMER50`) and share it with customers. The discount is applied only when the customer enters the code at checkout.
  </Card>

  <Card title="Automatic" icon="bolt">
    No code required. Cartble evaluates the rule against the cart automatically — if the cart meets all conditions, the discount is applied instantly without any customer action.
  </Card>
</CardGroup>

## Discount types

| Type              | How it works                                              | Example                           |
| ----------------- | --------------------------------------------------------- | --------------------------------- |
| **Percentage**    | Reduces the eligible subtotal by a percentage.            | 20% off all products              |
| **Fixed Amount**  | Deducts a flat monetary value from the eligible subtotal. | $10 off orders over $50           |
| **Free Shipping** | Waives the shipping fee when conditions are met.          | Free shipping on orders over \$75 |

## Application scope

When you create a discount, you choose which products it applies to.

<Accordion title="All Products">
  The discount applies to every item in your store. This is the broadest scope and is ideal for sitewide sales or welcome promotions.
</Accordion>

<Accordion title="Restrict by Product Type (Blueprint)">
  Limit the discount to a specific product category type. Available blueprint types are:

  * **Physical Products** — retail goods
  * **Digital Products** — downloadable files or links
  * **Services & Bookings** — appointment-based offerings
  * **Subscription Clubs** — recurring subscription products

  Use this scope when running a promotion that should apply only to one vertical, such as "20% off all subscriptions."
</Accordion>

<Accordion title="Specific Products">
  Hand-pick exactly which products are eligible. Select individual product IDs from your catalog. This is the most targeted scope and prevents the discount from being used on anything outside your selection.
</Accordion>

## Conditions and prerequisites

Add minimum thresholds to ensure a discount is only applied when the cart meets a baseline requirement.

| Condition                 | Description                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| **Minimum cart subtotal** | The cart must reach a set monetary value before the discount activates (e.g., \$50 minimum). |
| **Minimum item quantity** | The cart must contain at least a specified number of eligible items.                         |

You can combine both conditions on a single rule — for example, require at least 3 items **and** a \$30 subtotal.

## Usage limits

Control how many times a discount can be redeemed to protect your margins.

<CardGroup cols={2}>
  <Card title="Global usage limit" icon="chart-bar">
    Set a maximum number of times the discount can be used across all customers combined (e.g., 100 total uses). Set to `0` for unlimited uses.
  </Card>

  <Card title="One per customer" icon="user">
    Toggle **Yes (1 per Email)** to ensure each customer email address can only redeem the discount once, regardless of how many orders they place.
  </Card>
</CardGroup>

## Date range

Every discount can have a **start date** and an optional **end date**.

* The discount becomes active at the start date and time you configure.
* If you set an end date, the discount automatically deactivates after that date — no manual intervention required.
* Leave the end date blank to keep the discount active indefinitely (subject to usage limits).

## Active / Inactive toggle

Use the **Active in Store** / **Paused / Inactive** toggle to enable or disable a discount rule at any time, regardless of its date range or usage count. This is useful for quickly pausing a promotion during an incident or staging a rule before its start date.

## Creating a new discount

<Steps>
  <Step title="Open Discounts">
    From your admin dashboard, navigate to **Discounts** in the left sidebar.
  </Step>

  <Step title="Create a new rule">
    Click the **New Discount** button in the top-right corner of the Discounts page.
  </Step>

  <Step title="Choose the method">
    Select **Manual Coupon** if you want customers to enter a code, or **Automatic** if the discount should apply without a code. If you choose Manual Coupon, enter a code in the **Coupon Code** field or click **Generate random code** to have Cartble create one for you.
  </Step>

  <Step title="Set type and value">
    Choose **Percentage (%)**, **Fixed Amount (\$)**, or **Free Shipping** from the Discount Type selector. For percentage and fixed-amount types, enter the discount value in the corresponding field.
  </Step>

  <Step title="Define scope and conditions">
    Select the application scope (all products, by product type, or specific products). Optionally set a minimum subtotal or minimum quantity under **Minimum Prerequisites**.
  </Step>

  <Step title="Configure limits and dates">
    Set a global usage limit and toggle per-customer restrictions if needed. Enter the start date and, optionally, an end date.
  </Step>

  <Step title="Set status and save">
    Choose **Active in Store** to make the discount live immediately, or **Paused / Inactive** to save it without activating. Click **Create Discount** to save the rule.
  </Step>
</Steps>

<Tip>
  Give each discount an **Internal Title** that clearly describes its purpose (e.g., "Black Friday 20% OFF" or "Free Shipping South"). This title is only visible to you in the admin dashboard — customers only see the code or the discount line on their cart.
</Tip>

## Discount status labels

After creation, each discount in your list displays a status badge:

| Badge         | Meaning                                               |
| ------------- | ----------------------------------------------------- |
| **Active**    | The rule is live and currently accepting redemptions. |
| **Paused**    | The rule exists but has been manually disabled.       |
| **Expired**   | The end date has passed.                              |
| **Exhausted** | The global usage limit has been reached.              |