Skip to main content

MRR (Contracted) Changes Export


MRR (Contracted) Changes Export

The MRR (Contracted) Changes export summarizes contracted Monthly Recurring Revenue (MRR) changes when new subscriptions or amendments are created.

Contracted MRR is the expected MRR that accounts future upgrades, downgrades, upsells, and cancelations. 

Monthly recurring revenue (MRR) calculates subscription recurring fees normalized to a monthly value.

See Monthly Recurring Revenue for information on how MRR is calculated.

Supplementing the standard Zuora MRR that does not include discounts in the calculation, this export includes the impact of discounts at the subscription level and rate plan level. For example, if a 10% discount is applied to a rate plan on a $100 charge, the reported MRR value is $90.

This feature is deprecated and is not enabled by default. If you need to get insights about your subscription businesses, Zuora recommends Zuora Analytics. For details about Zuora Analytics, see Analytics overview.

This feature is unavailable if you have the Orders or Order Metrics feature enabled. See Order Metrics for more information.

Export Description

This export provides a summary of contracted MRR categorized by changes resulting from new subscriptions and amendments.

The following shows MRR contracted values grouped by customer account and viewed by month for a year timeframe starting on May 21, 2014.

MRR Contracted Momentum Report Exported to .CSV File

How Data is Exported

The MRR (Contracted) Changes export uses the following criteria to export data:

Amendment Create Date

The contracted MRR value is based on the date when the amendment was created, not when change becomes effective.

MRR Contracted Categories

The following describes how MRR contracted values are grouped: 

  • New Bookings: MRR changes by new subscription

  • Upgrades: MRR increase by amendment

  • Downgrades: MRR decrease by amendment

  • Cancellations: MRR changes by canceled subscription

  • Renewals: MRR changes by renewal amendment

  • Non-renewals: MRR changes by non-renewal subscription


Account-level Discounts

This export does not support account-level discounts. If an account has account-level discounts, the MRR value reported is the full MRR value. The impact of the discount is not factored in.

Discount on Charge Is for a Specified Period

This export does not support discount charges when discount is applied for specified period. The following is an example a product rate plan charge where the charge is discounted for up to 2 periods:

Discount Charge Options on a Product Rate Plan with Up to Months Specified

If the discount charge is for a specified period, such as a 2 periods, the MRR value reported is the full MRR value. The impact of the discount is not factored in. 

Early Renewals and Upgrades

Early renewals and upgrades contribute to the MRR in the week that the amendment is made rather than according to future dates for effective contract.  If for example, a subscription is not set to auto-renew and will expire in two months, if an early renewal is received, the contribution to MRR is reflected in the total MRR immediately.

Export File Size

The maximum export file size is 2047MB. If you have large data requests that go over this limit, you will get the following 403 HTTP response code from Zuora:

Submit a request at Zuora Global Support if you require additional assistance.

We can work with you to determine if large file optimization is an option for you.

How to Filter and Export MRR Data

The selected View By period and the timeframe to determine the MRR data that is exported to a .csv file for further analysis. The exported data is saved as a .zip file. The downloaded and unzipped file uses the following naming convention: MRRChangesReport_20150407201650, where 20150407201650 is the year, month, day, and time the export was created.

Do the following:

  1. Navigate to Reporting > Exports.
  2. Select MRR (Contracted) Changes from Export Data drop-down.
  3. Select your filters:
    • Group By: Account (only option)
    • View By: Week, Month, or Quarter
  4. Specify the start and end dates for the Time Frame Duration. The time frame you can specify is based on the selected View By period:
    • Week: Up to three months, where Sunday is the start of a seven day week
    • Month: Up to one year
    • Quarter: Up to three years
  5. Click Export

View By Week Example


For example if viewing MRR by week from January 24, 2015 to May 24, 2015, the time period columns represent the MRR values as follows:

Time Period Column MRR as of Example
First Column Duration Start Date 1/24/2015
Middle Columns First Day of the Week 1/24/2015, 1/25/2015, 2/1/2015, 4/19/2015
Last Column Duration End Date 4/24/2015

View By Month Example

Detail View By Month MRR Momentum Report

For example if viewing MRR by month for the last 12 months, the time period columns represent the MRR values as follows:

Time Period Column MRR as of Example
First Column

Duration Start Date

Middle Columns First Day of the Month 5/1/2014, 7/1/2014, 1/1/2015
Last Column Duration End Date 4/21/2015

View By Quarter Example

Detail View By Quarter MRR Momentum Report

For example if viewing MRR by quarter from April 24, 2015, the columns represent the MRR values as follows:

Time Period Column MRR as of Example
First Column Duration Start Date 4/24/2014
Middle Columns First Day of the Quarter 5/1/2014, 8/1/2014, 11/1/2015
Last Column Duration End Date 4/24/2015

Export Column Descriptions

Column Description
Account Number The unique account number assigned during creation to the customer account.
Customer Name The name of the customer account.
Currency Code The currency code associated with the transaction.
MRR (Contracted)

Categorized contracted MRR values by account.

Date Columns (MRR values) The reported MRR values in these columns are as-of the date specified in the column headings. The dates and the timeframe will vary based on the View By filter and Timeframe you select when exporting.