Promotion coupons

Developers can create promotion codes for eligible plans so customers receive a discount at checkout. Coupons are created per product (plan) from the workspace Products page or plan cards.

Which plans support coupons?

Coupons are available for subscription, usage (postpaid), and prepaid billing models. Other models may not show the Create Coupon action.

Promotion code

The code is what buyers type at checkout. Use only letters and numbers (no spaces). It is stored in uppercase. Pick something memorable and easy to share (e.g. LAUNCH25).

Discount type and value

  • Percentage — Reduces the eligible charge by that percent (1–100). Good for proportional savings on recurring or usage bills.
  • Fixed amount — Subtracts a fixed amount from the applicable charge. The platform currently applies fixed discounts in USD currency.

Duration

  • Once — The discount applies on the first invoice after the customer subscribes (or the first applicable charge), then stops.
  • Repeating — The discount applies for the number of billing periods you specify (months field). Each period is one invoice cycle for that subscription.
  • Forever — The discount continues on future invoices while the subscription remains active (subject to Stripe/product rules).

Expiration date

Optional. After this date, new customers can no longer redeem the code at checkout. Subscriptions already created with the coupon follow the duration rules you set when they subscribed.

Usage limits

  • Max total uses — Stops new redemptions after this many successful uses across all customers. Leave blank for no global cap.
  • Max per customer — Each paying customer (Stripe customer) can redeem at most this many times. Use 1 for a single use per buyer.

Managing existing coupons

On the workspace Products page, the Coupons section lists codes by plan. You can deactivate or reactivate a coupon there. To add another code, use Create Coupon on the plan card.

Related: Billing and usage.