# Promo Codes

Promo codes let you offer discounts, free trials, and free access to your content.

## Code Types

### Discount Codes

Reduce the price of an item, project, or membership tier.

- **Percentage discount**: 1% to 100% off
- **Fixed discount**: A specific dollar amount off the price

### Free Trial Codes

Give temporary access to membership content.

- Trial length: 1 to 365 days
- Fan subscribes at the end of the trial or access expires

### Free Access Codes

Grant permanent free access to a specific item. These use auto-generated word-based codes (easier to share verbally or in print). You can also provide a custom code up to 100 characters.

When a fan claims a free access code for an item that has license keys enabled, a license key is automatically generated for them.

## Creating a Promo Code

1. Go to your project dashboard and open the **Promotions** tab
2. Click **Create Code**
3. Choose the type (Discount, Free Trial, or Free Access)
4. Set the parameters:
   - **Discount**: percentage or fixed amount
   - **Free Trial**: number of days
   - **Free Access**: select the item
5. Optionally set a scope, start date, expiry date, and usage limit
6. Click **Create**

> [!UI] promo-code-form

Discount and free trial codes use custom uppercase alphanumeric codes you define (1-50 characters). Free access codes are auto-generated with memorable word combinations unless you provide a custom code.

## Scope

Codes can be scoped to different levels:

| Scope | Effect |
|-------|--------|
| Creator-wide | Applies to anything you sell |
| Project | Applies to items within a specific project |
| Item | Applies to a single item only |
| Tier | Applies to a specific membership tier |

## Scheduling, Expiry, and Limits

- **Start date**: Optional. Set a future date (YYYY-MM-DD) when the code becomes active. Before this date, the code cannot be redeemed. Activates at beginning of day UTC.
- **Expiry date**: Optional. Set a date (YYYY-MM-DD) after which the code stops working. Expires at end of day UTC.
- **Usage limit**: Optional. Set the maximum number of times the code can be redeemed.

Codes with no start date, no expiry, and no limit work immediately and indefinitely.

## Editing Codes

After creating a code, you can update its **start date**, **expiry date**, and **usage limit**. The code text, discount type, and discount amount cannot be changed -- delete and recreate if you need to change those.

## Managing Codes

From your project's Promotions tab you can:

- **List** all your promo codes with redemption counts
- **Edit** a code's dates and usage limit
- **Delete** a single code to deactivate it immediately
- **Bulk delete expired**: Remove all expired codes at once with the "Delete all expired" button

## How Fans Use Codes

Fans enter the promo code during checkout. For free access codes, fans can claim at a dedicated claim page without going through checkout.

## See Also

- [Selling & Audience](./03-selling.md): Pricing models and monetization overview
- [Pricing Models](../about/pricing.md): Detailed pricing guide