Skip to main content

View subscriptions

Zuora

View subscriptions

Each subscription contains important information about the order that a customer has placed, such as the charges for products or services. A subscription also includes the terms and conditions for when the charges are billed. When you view an individual subscription, you will see the following information.

Subscription Information

To view an individual subscription, access Subscriptions and select any subscription. This takes you to a page with detailed information about that subscription. The customer name and subscription number are displayed at the top of an individual subscription page.

Field Description
Subscription Number

A unique identifier for the subscription. It is also referred to as the subscription code.

For example: A-S00000080

If you are creating a subscription in the Zuora user interface, Zuora creates a number automatically. You cannot change the subscription number after creating the subscription. 

Customer Name

This is the name of the customer account (also referred to as a billing account) that is subscribing to your products or services.

Status

A subscription can be Draft, Active, Pending, ExpiredCancelled, or Suspended.

Suspend a subscription is in Limited Availability.

Initial Term

The length of the period for the first subscription term.

Current Term The length of the period for the current subscription term. 
Renewal Term

This is the length of the periods your subscription will renew for after the initial term ends.

Autorenew Indicates whether a subscription is set to automatically renew at the end of its term.

When the initial term for a subscription is over, and if Autorenew is set to true, the subscription will automatically renew. Your customer will continue to be billed for the number of periods specified by the renewal term.

If you set Autorenew to false, the subscription will expire after the initial term is over. Your customer will not be billed beyond the initial term.

Last Booking Date The last change date of a subscription. This field is writable only when the subscription is newly created as a first version subscription. The value of this field is as follows:
  • For a new subscription created by the Subscribe and Amend APIs and UI, this field has the value of the subscription creation date.
  • For a subscription changed by an amendment, this field has the value of the amendment booking date.
  • For a subscription created or changed by an order, this field has the value of the order date.
Notes This contains notes about your subscription.
Version

Zuora automatically generates a version number when you make a change to the subscription. Click the link to view more information about changes made to the current subscription.

Pending Amendments

This indicates whether amendments are pending (whether an amendment has been submitted but not yet executed.)

Change History

This field contains information about the latest changes made to the subscription. For more information, see View subscription change history.

Quote Number

The unique identifier of the Quote.

This field is used in the Zuora Reporting Data Sources to report on Subscription metrics.

If the subscription was originated from Zuora Quotes, the value is populated with the value from Zuora Quotes.

Quote Type The Quote type that represents the subscription lifecycle stage such as New, Amendment, Renew or Cancel. 

This field is used in the Zuora Reporting Data Sources to report on Subscription metrics.

If the subscription was originated from Zuora Quotes, the value is populated with the value from Zuora Quotes.

Quote Business Type

The specific identifier for the type of business transaction the Quote represents such as New, Upsell, Downsell, Renewal or Churn. 

This field is used in the Zuora Reporting Data Sources to report on Subscription metrics.

If the subscription was originated from Zuora Quotes, the value is populated with the value from Zuora Quotes.

Opportunity Name

The unique identifier of the Opportunity.

This field is used in the Zuora Reporting Data Sources to report on Subscription metrics.

If the subscription was originated from Zuora Quotes, the value is populated with the value from Zuora Quotes.

Opportunity Close Date

The closing date of the Opportunity. 

This field is used in the Zuora Reporting Data Sources to report on Subscription metrics.

If the subscription was originated from Zuora Quotes, the value is populated with the value from Zuora Quotes.

Additional Fields

Click Additional Fields to edit the Subscription Number (or it will be auto-generated) or the Term Start Date (if the term start date is different from the contract effective date).

By default, the billing term starts when the contract becomes effective, which is set when saving the subscription. However, you can enter a different term start date, if required.

Customer Acceptance Date

This is the date on which your customer accepted your subscription's products or services. See Dates in Zuora for more information about using subscription dates.

Contract Effective Date

This is the date on which your subscription, or contract, is effective.

Products

Each subscription is for products or services that you have sold. See Product Catalog for more information about setting up your subscription products.

Rate Plans

Each of your subscription products or services has a rate plan which describes how you are charging your product. See Creating a Product Rate Plan for more information.

Billing Timing

This field describes the billing timing of a rate plan charge. It can be In Advance or In Arrears for recurring charge types. This field is empty for other charge types.

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

Subscription List and Expanded Views

When you access the Subscriptions module, use the following tabs to view the list of subscriptions:

  • Expanded View is the default view that shows an image of the customer account and account name, along with the subscription number, CMRR (Contracted MRR), contract effective date, next renewal date, current term, renewal term, and the status of the subscription(active, cancelled, draft, pending activation, or pending acceptance). From this view, click view to view the subscription in detail or delete to delete the subscription.
  • List View is a more condensed view that shows the subscription number, status (active, cancelled, draft, pending activation, or pending acceptance), account name, along with the subscription CMRR (Contracted MRR), current term, renewal term, contract effective date, and version. Use the Action column to delete the subscription. Click a column header to sort the column for enhanced search capability.

Click the subscription number in either Expanded or List view to see detailed information about a specific subscription.

Subscription Views

Use the Subscription Views area (located in the upper-right of the Subscriptions page) to quickly see the status of your subscriptions, and view subscriptions by status.

Subscription Statuses

The subscription view makes it easy for you to take action on a specific group of subscriptions by clicking the applicable status link, which will open a page that contains only the subscription with that status. For example, click the Expired Subscriptions link to view all expired subscriptions in order to extend the subscription term, renew the subscription, or cancel the subscription.

You can sort by the following subscription statuses.

Status Description

Draft

Subscriptions in draft status are in-process and have not been activated.

Pending Activation

Subscriptions pending activation require an activation date be set in order to activate the subscription.

Pending Acceptance

Subscriptions pending acceptance require a customer acceptance date be set in order to activate the subscription.

Active

Active subscriptions have all the required subscription dates set and will be billed when the triggering conditions are met.

See Active Status Subtypes in the following section for more information.

Cancelled

Subscriptions that are cancelled may or may not continue to be billed based on the cancellation date. For example, if today is January 15th and a customer notifies you of his desire to cancel his service at the end of February, you can immediately set the subscription to cancelled status in Zuora Billing with a cancellation date of February 28th. The customer will continue to be billed for this subscription through February 28th.

Suspended

Subscriptions are put on hold until you bring them back to active status.

This feature is in Limited Availability

Active Status Subtypes

In addition, the Zuora web application (UI) displays two types of Active subscriptions:

  • Within a term: Subscriptions that have not reached the end of their term. 
  • Out of term: Subscriptions with an Active status, but have reached the end of their term. These subscriptions are considered "Out of Term," but remain active. You can renew these subscriptions or manually cancel them.

If you are using the Zuora API and want to find all active subscriptions that are still in the term, you must specify an additional query condition, querying for all subscriptions with a term end date that is greater than or equal to the current date. 

Subscription Status Cases

The following are common questions about subscription statuses:

What happens to both status when a Termed Subscription is not renewed? 

Nothing. The subscription status remains active, even if it is not renewed.

What is the status of a previous version of a subscription where the contract effective date on the new version has not been eclipsed yet?

The status of  previous versions is "Expired." Regardless of dates, the previous versions of the subscription will always be "Expired".

The "Expired" status does not indicate that a subscription has ended. In Zuora, the "Expired" status is used to identify old versions of a subscription. Zuora creates a new version of a subscription every time that you create an amendment for that subscription.

What is the status of the current version of a subscription where the contract effective date has not been eclipsed yet?

  • If the latest amendment (or order action) on the subscription is Cancel subscription, the subscription status is "Cancelled", as long as the dates are set.
  • If the latest amendment (or order action) on the subscription is Suspend, the subscription status is "Suspended", as long as the dates are set.
  • Otherwise, the subscription status is "Active", as long as the dates are set.

Subscription Charge Display

In the subscription, under Product & Charges, you can view your charges grouped by product, trigger condition, or key statistics. You can also view the date in which the charge was invoiced through and the history for that charge. Also, by clicking a specific charge name, you can get an expanded view of the detailed information for this charge. For example, you can check which charges are selected for discount application by clicking the discount charge name in the Product & Charges area and then identifying to the Charge Amount > Apply Discount To section.

Products & Charges Options

Use the Products & Charges area to view subscription information by product, by triggering condition, or by key statistics.

View By Product

This is the standard view and the default view in the system. This view displays the last segment of each rate plan charge in a product. To view all the segments of a rate plan charge, use View By Key Statistics and check the History column. 

View By Triggering Condition

Viewing your charges by triggering condition is helpful if, for example, you have a setup fee that is triggered immediately on the contract effective date as well as a recurring fee that is triggered off of the service activation date. See Triggering Conditions for more information.

View By Key Statistics

This view allows you to see your charges by MRR (Monthly Recurring Revenue) and TCV (Total Contract Value) at the charge level.

The Invoice Through Date column displays the last day of the service period for the charge on the most recent invoice. If the charge has not been invoiced, the field will be blank and no date will be displayed.

In the History column, click the icon to view the history for any given charge within a subscription. This is where you can see any amendments that have been made to a subscription, with each segment representing a version of the subscription. For example, if a charge has been updated via an amendment to increase the price from $2 to $4, the history will show two charge segments: the first charge segment will show a value of $2 and the second charge segment will show a value of $4. 

Configuring Your Subscription Products and Charges Display

You can choose the order in which the products and charges on a subscription are displayed in the user interface. To configure your products and charges display, within the subscription, click on the arrows to the left of the product or the charge to move them up or down in the list.