HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo

Monthly recurring revenue

Learn how Recurly's MRR dashboard calculates monthly recurring revenue, breaks it into components, and lets you drill into account-level detail.

The Monthly Recurring Revenue (MRR) dashboard gives you a deep, up-to-date view of your predictable monthly revenue. Track total MRR and MRR changes, break revenue down into its component parts, and drill into the specific accounts, plans, or add-ons behind any number.
Not included in Starter or Pro — contact Recurly Sales to upgrade
1Definition 2Key benefits 3Key details

Prerequisites

  • Users must have Analytics user role permission.

Definition

The Monthly Recurring Revenue (MRR) dashboard is a vital tool for subscription-based businesses, offering a deep dive into predictable monthly revenue patterns. MRR isn't equivalent to GAAP revenue, but it's a key metric that reflects your company's growth and revenue trends. Updated multiple times a day, the dashboard gives you fresh insight into successful and failed transactions, dunning activity, discounts, and projected MRR.
NoteIt's important to understand the difference between a subscriber and a subscription. A single subscriber might hold multiple active subscriptions, but this dashboard counts each individual subscriber — not the number of subscriptions they hold. For more on navigating and using the filter tools, see our analytics overview documentation.

Check the widget at the bottom of the dashboard to see when the data was last updated.

Key benefits

Revenue visibility See predictable monthly revenue, updated multiple times a day.
Trend tracking See whether MRR is growing or shrinking, and what's driving the change.
Dunning and discount insight See how failed transactions, dunning, and discounts affect your recurring revenue.
Account-level detail Drill into the accounts, plans, or add-ons behind any number on the dashboard.

Key details

What's included on the dashboard?

MRR is calculated from invoiced recurring charges, credits, and refunds on subscriptions. A charge counts toward MRR if its associated invoice line item has both a start date and an end date.

Included in the MRR calculation

  • Subscription and subscription add-on amounts
  • Manual recurring charges
  • Proration credit from a subscription downgrade or upgrade
  • Refund of a subscription amount

Not included in the MRR calculation

  • One-time charges without a start date and end date
  • One-time credits
  • Taxes
  • Usage-based billing amounts

Optional in the MRR calculation

You can choose to include or exclude each of these:

  • Recurring charges from failed invoices
  • Coupon discounts
  • Multi-currency support

For sites that support multiple currencies, the default view shows total MRR across all currencies, converted to your primary currency and summed. Conversion rates update daily using data from Open Exchange Rates. Historical MRR uses the conversion rate in effect when the charge was created, and doesn't change as current rates change.

Both the Total MRR graph and the MRR Break-Out let you drill into accounts, plans, or add-ons.

These drills show a detailed view of each account contributing to the number you selected, sorted by total MRR. Use the filter at the top to narrow the results by account or email.

For a more granular view, drill further into a specific account by selecting its Total MRR or Total Annual Recurring Revenue (ARR) number.

This deeper drill shows all the charges that contribute to the total MRR or ARR for the selected account. The same drill-down functionality is available in the MRR Growth section.

MRR Break-Out

This feature gives you a detailed breakdown of the four components that make up total MRR, with the ability to drill into account-level specifics for each one.

Discount and failed-invoice settings are both built into your analytics settings, giving you four possible default states — the Total MRR shown reflects whichever combination you've chosen.

NoteIf you change your analytics settings within Recurly, the Total MRR line in the chart updates to match — and this change is also reflected in the Total MRR chart and table.

The "In Dunning" series shows the MRR from the current period that's still going through Recurly's revenue collection process. Invoices that remain uncollected after retries move into the failed category and drop out of the MRR report once the subscription's end date has passed.

"Expected MRR" is the amount for the daily, weekly, or monthly period that hasn't been collected yet. Monthly and weekly views show data for the last day of the period; the daily view shows the month's progression in more detail.

In this section, you can view MRR by:

  • Collected MRR
  • MRR in dunning
  • Expected MRR (based on upcoming subscription bills)
  • Discounts applied to MRR
  • Total MRR (the sum of MRR, In Dunning, and Expected MRR, minus discounts)

As with the MRR graph, you can drill by account, plan, or add-on, and dig even deeper as needed.

Ways to use the MRR dashboard

MRR data helps you answer key questions for your subscription business, such as:

  • What revenue can I expect each month?
  • Is revenue increasing or decreasing month over month?
  • Are my monthly recurring revenue targets being met?

Analyzing the MRR dashboard gives you a deeper understanding of your revenue trends, so you can make informed decisions that drive growth and meet your financial goals.

Updated 3 days ago

Did this page help you?