> ## 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.

# Provisioning subscriptions

To manually provision a subscription from the [Stigg app](https://app.stigg.io):

1. Click **+ Add** under the **Subscriptions** section of the customer details screen.

2. In the opened screen, enter the required details:

   ### Subscription content

   1. **Product**: Required when more than one product exists; otherwise preselected.
   2. **Resource ID**: The ID of the entity the subscription applies to (e.g., website ID, app ID). Used for products that allow [multiple active subscriptions](/guides/i-want-to/add-multiple-subscriptions).
   3. **Plan**
   4. **Billing period**: Relevant for [paid plans](../../modeling-your-pricing-in-stigg/plans#paid-plans), such as monthly or annual.
   5. **Plan configuration**
      * Set unit quantities for:
        * [In-advance commitment charges](../../modeling-your-pricing-in-stigg/plans#in-advance-commitment)
        * [Variable entitlements](../../modeling-your-pricing-in-stigg/plans#defining-variable-entitlement-values)
      * (Optional for paid plans) Override default plan prices.
   6. **Add-ons**: Select optional add-ons compatible with the chosen plan.

   ### Subscription start date

   1. **Immediately**: Default option.
   2. **At the end of the current billing period**: Applies if an active paid subscription already exists.
   3. **Specific date**: Allows backdated or future subscriptions.
      * Past start date → customer is billed starting next billing period.
      * Future start date → subscription becomes active on that date.

   <Note>
     When a subscription is created with a start date in the past, the first billing charge will only occur in the following billing period — not immediately. This is useful when a customer has already paid for the subscription through another means (e.g., a manual payment or an external system), ensuring they are not charged again for the current period.
   </Note>

   ### Free trial

   * Applicable to [paid](../../modeling-your-pricing-in-stigg/plans#paid-plans) and [custom](../../modeling-your-pricing-in-stigg/plans#custom-plans) plans.
   * The plan’s default trial setting is preselected but can be overridden.

   ### Spend management for on-demand charges

   1. **Minimum spend**: Charged in advance; on-demand usage deducts from this amount. Overages appear on the next invoice. Can override plan defaults.
   2. **Maximum spend**: Enforces a hard stop when the usage limit is exceeded.

   ### Discounts

   * Discounts are applied via [coupons](../../modeling-your-pricing-in-stigg/coupons).
   * Customizing a coupon creates an ad-hoc subscription-specific coupon that does not appear in the product catalog.

   ### Payment method

   1. **Automatically use payment method on file**: Required for paid plans.
   2. **Generate an invoice**: Useful for wire transfers or payment links. More details [here](/guides/i-want-to/bill-customers-using-invoices).
   3. **Don’t use Stigg for payments**: Stigg manages entitlements only.

   ### Billing

   Available for paid plans when Stigg is integrated with a billing solution (Stripe, Zuora, or a custom billing provider).

   1. **Billing anchor**: Controls where the billing cycle is anchored for this subscription.
      * **Unchanged** (default): Keeps the existing billing cycle anchor.
      * **Reset to now**: Resets the billing cycle anchor to the current timestamp. Use this when upgrades or quantity increases should start a fresh billing period immediately.
   2. **Proration**: Determines how the financial impact of the subscription change is handled.
      * **Prorate now**: Generates and collects a prorated charge immediately.
      * **Prorate + include in next invoice**: Creates proration line items and defers the charge to the next billing cycle.
      * **No proration**: Disables proration entirely for this subscription.

   <Note>
     To configure billing anchor and proration programmatically when provisioning subscriptions via the SDK, pass the `billingCycleAnchor` property (`SubscriptionBillingCycleAnchor.UNCHANGED` or `SubscriptionBillingCycleAnchor.NOW`) and the `subscriptionProrationBehavior` property.
   </Note>

3. Review the subscription summary.

4. Click **Create** to provision the subscription.

***

<Warning>
  1. A customer can have at most one active trial and one active non-trial subscription per product.
  2. Provisioning a new trial cancels any existing trial for the same product at the new trial’s start date.
  3. Provisioning a new paid/non-trial subscription cancels the existing non-trial subscription at the new subscription’s start date.
  4. Upgrading from trial → paid starts the paid plan at the end of the trial.
  5. In *self-served* flows:
     * Customers get only one free trial **per product**.
     * Customers who have already paid for a plan are not eligible for another free trial.
     * Admins can override these limitations via the Stigg app.
</Warning>

<Note>
  To provision a paid subscription, the customer must have a valid payment method stored in the integrated [billing solution](../../native-integrations/overview#billing).\
  Admins can add payment methods on behalf of customers when needed (e.g., during onboarding).\
  Payment methods are **never stored in Stigg**.
</Note>

<Note>
  Stigg uses a **generous** entitlement model: when a customer has both a trial and an active subscription, whichever configuration or quota is more generous will take precedence.\
  You can determine the final entitlement results using the [entitlement summary view](#entitlement-summary).
</Note>