Reading starts here
ChurnAtlas

Coupon duration: 3 types to check before renewal

Short answer. See the three coupon duration types to check before a renewal bill, plus the numbered limits on discounts, months, invoices, and renewal periods.

ChurnAtlas Editorial Team. Written by an AI model on local hardware. Nobody edits or reviews it by hand.

Published · Sources checked · 11 min read

  1. Inputs The agreement, the customer's budget and approval dates, and the results so far.
  2. Decision When to start, and what evidence the customer will want to see.
  3. Next action Fill in the renewal sheet and book the first conversation.

A coupon lasts once, for a set number of months, or indefinitely, as defined by Stripe.

Key takeaways for coupon duration types before the renewal bill

  • Chargebee lists three options under Coupon Duration, which you can write down before checking the live coupon according to Chargebee.
  • Stripe states that you can apply up to 20 discounts to a subscription, subscription item, or invoice according to Stripe.
  • Identify whether the live coupon applies once, for a set number of months, or indefinitely.

A coupon lasts once, for a set number of months, or with no end date

The three duration shapes named by Stripe are one-time application, a fixed number of months, and an indefinite period. Stripe instructs users to set a coupon to apply once, for a set number of months, or indefinitely. Chargebee states there are three options available under Coupon Duration. Recurly allows a relative expiration period that starts individually for each unique code when it is generated, rather than when the coupon is created. Maxio requires entering a whole number from 1 to 120, then choosing the length of one renewal period from the interval drop-down, for example 1 month.

The one-time shape applies the discount only once when the coupon is applied to the subscription. The fixed-period shape limits the discount to a specific count of months or renewal cycles. The indefinite shape has no end date defined in the duration setting. Stripe uses the term "indefinitely" for this third option.

When checking a renewal bill, identify which of these three shapes the live coupon uses. The shape determines how many future invoices will carry the discount. A fixed-period coupon affects a specific number of future invoices. An indefinite coupon affects all future invoices indefinitely.

The distinction between validity and duration is critical. Validity usually refers to when the coupon can be used. Duration refers to how long the discount lasts after application. Chargebee separates these concepts in its documentation. See health score validity for a related validity check. Stripe describes the application scope. Recurly describes the expiration timing. Maxio describes the renewal period count.

For a customer success manager, knowing the duration shape prevents miscommunication about future billing. See onboarding project plans before that talk. If a customer expects a discount to continue, verify the duration setting. If the duration is one-time, the discount is applied only once when the coupon is applied to the subscription. If the duration is fixed-period, count the remaining months. If the duration is indefinite, the discount continues indefinitely.

A filled reference table of coupon duration rules

The table below gives one row for each publisher in that publisher's own words. Each row names the publisher and the specific limit or example their page provides.

Publisher Duration Type Named Specific Limit or Example
Chargebee One time and forever Three options under Coupon Duration Chargebee
Stripe Once, set number of months, indefinitely Apply once, set number of months, or indefinitely Stripe
Maxio Whole number of renewal periods 1 to 120, then choose interval length Maxio

Use this table to match the live coupon setting against the documented options for your specific platform.

Stripe's 20-discount cap and the 4-month example

When checking how long a discount lasts on the next renewal bill, the number of active discounts matters as much as the duration type. Stripe documents a specific limit on how many discounts can be attached to a billing object. You can apply up to 20 discounts to a subscription, subscription item, or invoice, according to Stripe. This cap applies to the billing objects listed in that documentation. It does not define the duration of a single discount; it defines the maximum count of discount objects that can exist on one subscription, item, or invoice at once.

The same Stripe documentation page describes a scenario involving first-time customers and redemption limits. It only works for first-time customers with a minimum spend of 50 USD, and you want to cap it at 500 redemptions, according to Stripe. This sentence describes a configuration choice for a specific coupon setup, not a universal rule for every customer. The 50 USD minimum spend and the 500-redemption cap are parameters within that example. They do not describe the duration of the discount itself. They describe eligibility and volume limits for the coupon code.

Stripe’s documentation also provides examples of how a time-limited coupon behaves across different billing cycles. In a monthly subscription, the coupon applies to the first 4 invoices, according to Stripe. This example shows a discount that runs for a set number of billing periods. The four invoices represent the duration of the discount in that specific monthly scenario. The discount does not continue after the fourth invoice in this example. It ends when the fourth invoice is processed.

For yearly subscriptions, the behavior differs based on the renewal timing. In a yearly subscription, the 50% discount applies to the entire year if the subscription renews within the 4-month window, according to Stripe. The 4-month window is the renewal-timing condition, not the length of the discount. If the renewal happens within that window, the discount covers the full yearly period. If the renewal does not happen within that window, the specific condition for applying the 50% discount to the entire year is not met.

These examples show that Stripe uses specific counts and time windows to define when a discount stops applying. The 20-discount cap limits the number of concurrent discounts. The 4-invoice count limits the duration for monthly subscriptions in the example. The 4-month window limits the renewal timing for yearly subscriptions in the example. Each of these is a distinct rule or parameter. They do not all describe the same thing. The 20-discount cap is a quantity limit. The 4-invoice and 4-month figures are duration or timing limits.

Chargebee's three duration types and the 5-month example

Chargebee Docs defines three distinct ways a coupon discount can run on a subscription, and each choice changes how many invoices the discount touches. The first option is one time, where the coupon discount is applied only once when the coupon is applied to the subscription, according to Chargebee. When you are preparing a renewal conversation, this is the shape to check if the customer expects the discount to be a one-off incentive rather than an ongoing reduction.

Another option allows you to set a specific number of months for the discount to remain active. Chargebee Docs explains that if you set 5 months in this option, the coupon will be applied to every recurring invoice generated in the first 5 months of the subscription, according to Chargebee. The documentation clarifies the practical effect of this setting by noting that if it is a monthly subscription, the coupon is applied 5 times, according to Chargebee. This distinction between the duration setting and the billing frequency is critical for your renewal notes. A 5-month duration on a monthly plan results in five separate discounted invoices, not a single five-month discount applied to one large invoice. You should verify the billing frequency of the specific account before stating how many times the discount will actually appear on the customer's statements.

The third option is forever, which indicates the discount has no end date in terms of duration. However, Chargebee Docs distinguishes duration from validity, noting that a forever coupon having validity as February 20, 2020, can only be applied to a subscription until that date, according to Chargebee. This example illustrates that even a "forever" duration type is subject to a validity window that determines when the coupon can be applied to a subscription. For your renewal bill, the key is to confirm whether the coupon was applied before the validity date and whether its duration is set to forever or a set number of months. If the duration is forever, the discount continues on every renewal invoice indefinitely, provided the subscription remains active. If the duration is a set number of months, it stops after the specified number of months.

Recurly's relative code expiry and Maxio's 1-to-120 renewal periods

Recurly allows you to set a relative expiration period, such as 7 days, 2 weeks, or 1 month, that starts individually for each unique code when it's generated, rather than when the coupon is created, according to Recurly. This timing distinction matters when a customer success manager explains why one code expired while another generated on a different day remains active. The relative clock does not run from the moment the coupon is created; it runs from the specific generation event of that unique code.

Maxio defines the duration of a discount by the number of renewal periods it applies to. You enter a whole number from 1 to 120, then choose the length of one renewal period from the interval drop-down, for example 1 month, according to Maxio. This range represents the count of renewal periods the page allows you to enter, not the size of the discount itself. A manager checking a renewal bill must verify both the number entered and the interval selected to understand the total duration.

By default, the discount applies once, at signup, according to Maxio. Maxio clarifies that a coupon set to 3 renewal periods of 1 month does not apply once a year for 3 years on a Subscription that renews yearly, according to Maxio. The duration is tied to the billing cycle frequency, not the calendar year.

For unique codes, Maxio specifies that if a coupon has 100 codes, each code can be used exactly once, according to Maxio. This limits the total number of customers who can redeem the coupon to the number of codes generated. To help your team quickly identify the purpose of a coupon, Maxio recommends giving it a descriptive internal name, up to 255 characters, according to Maxio. A clear name helps distinguish between different duration configurations when reviewing multiple active coupons.

When preparing to explain a discount to a customer, note whether the system uses a relative code expiration like Recurly or a fixed renewal period count like Maxio. Check the specific interval drop-down selection in Maxio to confirm the length of each period. These checks ensure the manager states the correct duration on the next renewal bill.

Illustrative example

A monthly price of 100 with a discount set for 10 months shows the discount on 10 invoices, then returns to 100. One invoice inside those 10 months is not 10 discounted invoices.

Do this before the renewal conversation

Today, open the live coupon and write down whether it applies once, for a set number of months, or indefinitely, then count the invoices still inside that duration. See pipeline stage labels before you explain the next bill.

FAQ on coupon duration

What three duration options does Chargebee list?

Chargebee lists three options available under Coupon Duration, according to Chargebee. These three choices define how long the coupon remains active on the subscription.

What does Chargebee's 5-month example do on a monthly subscription?

If you set 5 months, the coupon will be applied to every recurring invoice generated in the first 5 months of the subscription, according to Chargebee. This example illustrates how a month count maps to recurring invoice cycles.

What relative expiry examples does Recurly give for a unique code?

Recurly documentation gives 7 days, 2 weeks, or 1 month as examples of a relative expiration period for a unique code, according to Recurly. This relative period starts individually for each unique code when it is generated, rather than when the coupon is created.

What whole-number range does Maxio give for renewal periods?

Maxio documentation instructs you to enter a whole number from 1 to 120 for the number of renewal periods, according to Maxio. You then choose the length of one renewal period from the interval drop-down, for example 1 month.

Sources

Limits of this post

This post is general operational information, not legal advice about notice periods or renewal clauses. It does not promise that any method keeps a customer. A review model checked the facts once, and that check can miss errors, so open the sources before you act.