Skip to main content

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

​
Configuring termed subscriptions via metadata

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.

​
Renewal behavior

The ZUORA__RenewalSetting and ZUORA__AutoRenew metadata keys control what happens when a termed subscription reaches its end date:

​
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:

​
Entering metadata in the dashboard

When adding or editing subscription metadata in the Stigg dashboard, ZUORA__ keys and their allowed values are available via dropdown menus — no need to type them manually.
  • Key field: typing Z or ZUORA filters the dropdown to show all supported ZUORA__ keys.
  • Value field: for keys with a fixed set of allowed values (e.g. ZUORA__TermType, ZUORA__PeriodType, ZUORA__RenewalSetting), the value field displays a dropdown with the valid options. For numeric keys like ZUORA__InitialTerm, a free-text input is shown instead.
ZUORA__ key dropdown in the Add metadata dialog
Value dropdown for ZUORA__RenewalPeriodType showing Day, Week, Month, Year options
Value dropdown for ZUORA__RenewalSetting showing RENEW_WITH_SPECIFIC_TERM and RENEW_TO_EVERGREEN options

​
Converting an existing subscription to termed

Subscriptions created in the Stigg dashboard are Evergreen by default. To convert an existing subscription to a Termed subscription, update its metadata directly from the subscription details page:
  1. In the Stigg dashboard, navigate to the Subscription details page of the subscription you want to convert.
  2. Click Edit on the Metadata section.
  3. Add the relevant ZUORA__ metadata keys (see the configuration table above). Use the key and value dropdowns to reduce errors.
  4. Save the changes.
Upon saving, Stigg syncs the updated metadata to Zuora and converts the subscription from Evergreen to Termed with the specified term settings.
If the subscription is already Termed in Zuora, updating these metadata values will issue an amendment to the existing term.
To convert a Termed subscription back to Evergreen, set ZUORA__TermType to EVERGREEN and save.
For general information on how Stigg metadata is mapped to Zuora custom fields, see the metadata synchronization section in the Zuora overview.