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

# Recurring credits

## Overview

Recurring credits allow you to sell prepaid usage that renews on a fixed billing cadence (monthly or yearly). Each credit represents a unit of value that customers can spend on metered features.

Credits are deducted in real time as usage is reported. Depending on your configuration, customers can also purchase additional credits through top-ups or be charged for overages.

<Note>
  **Including credits in plans as entitlements**: You can also grant recurring credits directly as entitlements on any plan or add-on - including free, paid, and custom plans - without configuring a billing charge. This is ideal for "included credits" scenarios like "5,000 AI credits per month on the Pro Plan". See [Adding entitlements to plans](../plans/assigning-features-plans#credit-entitlements) for setup instructions.
</Note>

## Setting up a recurring credits plan

This section walks through creating a paid, recurring plan that grants credits on each billing period.

1. Go to **Product catalog → Plans**.
2. Click **+ New plan**.
3. Select the product the plan belongs to.
4. Enter the plan name, ID, and an optional description.
5. Click **Create**.
6. In the **Price** section, click **+ Set**.
7. Set **Plan type** to **Paid**.
8. Click **Continue**.
9. Under **Billing model**, select **Recurring**.
10. Select the required billing period (monthly or yearly).
11. Click **Continue**.
12. In the **Charges** section, select **Credits**.
13. Click **Continue**.
14. In the **Credits - Credit** configuration:
    * Select the **credit type**
    * Choose the **pricing model**
    * Configure the **credit grant cadence**
15. Click **Add**.
16. (Optional) In the **Credit consumption** section, map the metered features that will consume credits. This defines the feature → credit burn rate.
17. (Optional) Configure **overage charges** if you want to bill customers for usage beyond their credit grant.
18. (Optional) Configure **Credit top-up** to allow customers to purchase additional credits beyond their recurring grant.
19. (Optional) Configure additional settings such as:
    * Free trial
    * Minimum spend
    * Price localization
20. Click **Publish** to make the plan available.

## Provisioning a subscription with recurring credits

Use these steps to assign a recurring credits plan to a customer.

1. Go to **Customers → Customer accounts**.
2. Select the required customer.
3. Under **Subscriptions**, click **+ Add**.
4. Select the product that includes the recurring credits plan.
5. Select the plan.
6. Select the number of credits or credit tier.
7. Add a payment method for billing.
8. Click **Create**.

The customer will now receive credits based on the plan’s billing cadence.

## Upgrading or downgrading a subscription

Upgrades and downgrades are handled by assigning a new recurring credits plan.

1. Create a new plan if required.
2. Go to **Customers → Customer accounts**.
3. Select the required customer.
4. Under **Subscriptions**, click **+ Add**.
5. Select the product that includes the recurring credits plan.
6. Select the new plan.
7. Select the required number of credits or credit tier.
8. Add or confirm the billing method.
9. Click **Create**.

<Note>
  When a plan is changed, the previous credit grant is voided and replaced by the new grant.
</Note>