Overview
Zuora supports two subscription term types:
- Evergreen — subscriptions that renew automatically and have no fixed end date. This is the default behavior in Stigg’s Zuora integration.
- Termed — subscriptions with a defined start and end date. After the term ends, the subscription can either renew for another specific term or convert to an evergreen subscription, depending on the configured renewal settings.
To create a termed subscription in Zuora, add the relevant ZUORA__ metadata keys to the subscription in Stigg. Stigg will map these to the corresponding Zuora fields when syncing the subscription.
All metadata values are case-insensitive.
| Stigg metadata key | Zuora field | Possible values |
|---|
ZUORA__TermType | initialTerm.termType | TERMED | EVERGREEN |
ZUORA__InitialTerm | initialTerm.period | Whole number (e.g. 12) |
ZUORA__RenewalTerm | renewalTerm.period | Whole number (e.g. 12) |
ZUORA__PeriodType | initialTerm.periodType, renewalTerm.periodType | Day | Week | Month | Year (default: Month) |
ZUORA__RenewalSetting | renewalSetting | RENEW_TO_EVERGREEN | RENEW_WITH_SPECIFIC_TERM |
ZUORA__AutoRenew | autoRenew | true | false |
Renewal behavior
The ZUORA__RenewalSetting and ZUORA__AutoRenew metadata keys control what happens when a termed subscription reaches its end date:
ZUORA__RenewalSetting | ZUORA__AutoRenew | Behavior |
|---|
RENEW_WITH_SPECIFIC_TERM | true | Subscription automatically renews for the duration set in ZUORA__RenewalTerm, indefinitely until cancelled. |
RENEW_TO_EVERGREEN | true | Subscription converts to evergreen upon renewal — no further expiry date. |
| Any | false | Subscription is not automatically renewed. It becomes “Out of Term” but remains active until manually renewed or cancelled. |
Example: creating a 12-month termed subscription
To create a subscription with a 12-month initial term that renews for another 12 months automatically, set the following metadata on the subscription:
| Key | Value |
|---|
ZUORA__TermType | TERMED |
ZUORA__InitialTerm | 12 |
ZUORA__PeriodType | Month |
ZUORA__RenewalTerm | 12 |
ZUORA__RenewalSetting | RENEW_WITH_SPECIFIC_TERM |
ZUORA__AutoRenew | true |
Updating the term type
Stigg supports updating subscriptions between term types at any time:
- Evergreen → Termed: set
ZUORA__TermType to TERMED and provide the relevant term metadata.
- Termed → Evergreen: set
ZUORA__TermType to EVERGREEN.
For general information on how Stigg metadata is mapped to Zuora custom fields, see the metadata synchronization section in the Zuora overview. 
