> This page is for Docs. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://zuora.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server. # MRR (Contracted) Changes Export > Learn about MRR (Contracted) Changes export Learn about 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. > **Note** > > 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. > **Note** > > This feature is deprecated and is not enabled by default. If you need to get insights about your subscription businesses, Zuora recommends Zuora Analytics. > > 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](/_fern-img/d85e8d98d990e6c237b353ec82cd31964f5c6689cc266b521e2f513f6a340a7f.webp) ## How data is exported The MRR (Contracted) Changes export uses the criteria in the next two sections "Amendment create date" and "MRR contracted categories" 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 ## Limitations See the following sections on this page: * Account-level discounts * Discount on charge is for a specific period * Early renewals and upgrades * Export file size ## 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](/_fern-img/d20c126ebe3090cfb199394d48448f9e5e53c18f11e876ddef8660f03d3a6ed7.webp) 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: `2047MB` Submit a request at [Zuora Global Support](http://support.zuora.com/) 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 ![Momentum by week](/_fern-img/8e5af870502da40cbea7e3a2a5107104cc28bdf0ff4765caf2e84ac9be422d5d.webp) 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 monthly example ![Momentum by month](/_fern-img/982cd59d2d606710c0f8e4a3a65fb3a06201b458f746503e8d0952b709f3488d.webp) 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 | 4/21/2014 | | 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 ![Momentum by quarter](/_fern-img/e3a360770fd245b955a8d6c5abe4caa1df4795893939d7205285e95c6a661e18.webp) 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. |