SaaS metrics dashboard: how to design MRR, churn and retention screens

By Ingot UI10 min read

A SaaS metrics dashboard should show MRR and how it moved, the number of active subscriptions, ARPU and churn in one KPI row; then explain MRR with a 12-month trend and a plan mix; then show retention by cohort and the customers at risk right now. The pages that earn their keep are the ones where people can act: recover a failed payment, change a plan, or follow up with a customer who might cancel.

Summarize withChatGPTClaudePerplexity

On this page
  1. The metrics a subscription business actually checks
  2. The overview: KPI row and MRR trend
  3. Plans, mix and ARPU
  4. Churn: count it, then explain it
  5. Retention by cohort
  6. Subscriptions and failed payments
  7. Customers at risk
  8. Targets and projections
  9. Customer detail: one page per account
  10. Upcoming renewals
  11. How to calculate the numbers correctly
  12. Building it with an AI agent
  13. Mistakes to avoid on SaaS dashboards
  14. SaaS metrics dashboard checklist

The screens in this guide come from Vantage, the business admin and subscriptions system in Ingot UI. It has 384 components from 70 source screens, including 17 KPI and stat components and 43 charts. The numbers in the screenshots are sample data; the patterns are what matter.

The metrics a subscription business actually checks

There are dozens of SaaS metrics. A dashboard should show the handful that change decisions, and define them clearly. This is the core set:

MetricWhat it tells youHow it is usually calculated
MRRRecurring revenue you can count on each monthSum of monthly subscription value of active subscriptions
Net new MRRWhether MRR grew, and whyNew + expansion − contraction − churned MRR
Active subscriptionsSize of the paying baseSubscriptions not cancelled or expired at period end
ARPUAverage value of a paying accountMRR ÷ active paying accounts
Customer churnShare of customers who leftCustomers lost in period ÷ customers at start
Revenue churnShare of revenue that leftChurned + contraction MRR ÷ MRR at start
Retention by cohortWhether newer customers stay longerShare of each signup month still active N months later
Past dueRevenue at risk from failed paymentsCount and value of subscriptions with an unpaid invoice

A word on annual plans: count them as one twelfth of the annual price per month in MRR, and say so in the definition. Showing the full annual payment in the month it arrives makes MRR jump and fall for no business reason.

The overview: KPI row and MRR trend

The top of a SaaS overview should answer “are we growing?” in two seconds. The Vantage KPI strip does this with MRR, active subscriptions and ARPU, each with a change vs the prior period. Keep the comparison period explicit; “vs prior” should mean the same thing on every card.

Under it, the MRR trend shows the last 12 months. The Vantage MRR section pairs the trend with each segment’s share of the total, which answers the next question (“where does the MRR come from?”) without another chart. Twelve months is the right default: long enough to see seasonality, short enough that recent changes are visible.

Show why MRR moved

A single MRR line hides the story. Two businesses can both grow 3% while one adds 10% and loses 7%. Add a movement breakdown: new, expansion, contraction and churned MRR, as stacked bars per month or a waterfall for the current month. The Vantage net movement chart is built for this question.

Copy to Figma (Pro)Copy React code (Pro)Save
KPI stripVantage Pro
Copy to Figma (Pro)Copy React code (Pro)Save
MRR sectionVantage Pro
Copy to Figma (Pro)Copy React code (Pro)Save
Copy to Figma (Pro)Copy React code (Pro)Save
Plan mixVantage Pro
KPI strip, MRR trend, net movement and plan mix from Vantage.

Plans, mix and ARPU

Most pricing decisions start from the plan mix: how many customers are on each plan, and how well each plan keeps them. Show it as a short list or donut with counts, like the Vantage plan mix, and pair it with retention per plan.

The Vantage plan retention card lists each plan with its price, subscriber count and retention rate. In its sample data, the mid-priced plan retains better than the cheapest one, which is a common real pattern and a useful prompt for pricing tests. Put the price next to the plan name; people reason about plans by price, not by name.

For businesses that sell through partners, teams or regions, add a revenue table by group. The Vantage revenue by leg table shows active subscriptions, MRR, share, churn and a 12-month trend per group in one row, so the best and worst groups stand out.

Churn: count it, then explain it

Show churn as a rate with a threshold, not just a count. An alert like the Vantage churn above 2.5% rule, which shows the current value next to the threshold, turns a number people forget to check into a signal that finds them. Let people create their own alert rules with a create alert modal: metric, condition, threshold.

Capture the reason at cancellation

Churn numbers say how many; reasons say why. Ask for a reason in the cancel flow with a short list of options, and show the results in the dashboard. The Vantage cancel subscription popover lists reasons such as price, moved away and not using it, each with its count this period. One look tells the team whether the problem is price, fit or onboarding.

  • Keep the list to five to seven reasons plus “Other”, or the data becomes noise.
  • Put the most common reason at the top so the list reflects reality.
  • Link each reason to the customers who chose it, so someone can follow up.

Retention by cohort

Cohort retention is the best long-term health check for a subscription product: it shows whether customers who joined recently stay longer than those who joined a year ago. The standard view is a grid: one row per signup month, one column per month since signup (M0, M1, M2…), and each cell shaded by the share still active.

The Vantage retention grid follows this layout. Three details make a grid readable:

  1. 1Use one colour with increasing intensity, not a red-to-green scale, so the grid works for colour-blind readers.
  2. 2Print the percentage in each cell; shading alone is not precise enough.
  3. 3Leave future cells empty rather than zero, so a young cohort doesn’t look like it churned.

A tooltip on each cell should show the cohort size and the count still active, so people can tell a 50% cohort of four customers from one of four hundred.

Subscriptions and failed payments

Failed payments are often the easiest revenue to recover, and the dashboard is where recovery happens. Give past-due subscriptions their own stat and list:

Open the full Vantage subscriptions page to see these pieces together. The pattern (stats, queue, drawer with actions) is the same one we recommend for any operational page; see modal vs drawer for why the detail belongs in a drawer.

Copy to Figma (Pro)Copy React code (Pro)Save
Stat, Past dueVantage Pro
Copy to Figma (Pro)Copy React code (Pro)Save
Stat, PausedVantage Pro
Copy to Figma (Pro)Copy React code (Pro)Save
Copy to Figma (Pro)Copy React code (Pro)Save
Past-due recovery: stats, the subscription drawer and its actions.

Customers at risk

Retention work is easier before a customer cancels. An at-risk table lists customers whose behaviour suggests they might leave: failed payments, falling usage, no logins. The Vantage at-risk table shows customer, group, plan, last payment, risk level and owner. The owner column matters most: a risk nobody owns is a risk nobody handles.

Link it to the full customers table, which adds status, customer since, payments over 12 months and lifetime value. LTV next to risk helps a team decide which customers to call first.

Targets and projections

A dashboard that only looks back can’t tell a team whether they are on track. Add a target:

  • Let people set one with a modal like set a revenue target, which shows the current value and the gap as they type.
  • Show progress with the amount still to go and the days left, as the Vantage August target card does.
  • For planning, show scenarios against a base case. The Vantage MRR scenario tooltip compares a scenario’s projected MRR with the base and shows the difference.

The Vantage projections page puts these together for forward-looking planning.

Customer detail: one page per account

Every metric on a SaaS dashboard eventually leads to “which customers?”. The customer view is where that question ends, so it should hold everything a team needs before contacting someone:

  • Plan, seats, MRR, tenure and lifetime value at the top, like the Vantage MRR stats in the customer drawer.
  • Payment history with failed and retried payments marked.
  • Recent activity and usage, so people can tell an inactive customer from a busy one.
  • Owner and next follow-up, with a way to reassign.
  • Plan changes and cancellation as actions in the drawer footer, not buried in settings.

Use a drawer when people work through a list of customers, and a full page when they need a long history. Vantage opens customers in drawers from its tables, such as the Colmado Díaz drawer, so the list stays in view.

Upcoming renewals

Renewals are predictable revenue events, and a short list of the next ones helps a team act before a card fails or a customer leaves. The Vantage renewals card lists upcoming renewals by date with the customer, plan, auto-renew status and amount. Put it on the home page next to past-due, so the team sees both what is coming and what is late.

How to calculate the numbers correctly

Design can’t fix wrong numbers, but it can make mistakes visible. Agree on these rules with whoever owns the data, then write them into the definitions:

QuestionCommon choiceWhy it matters
When does churn count?At the end of the paid period, not the day of cancellationCounting on cancellation day overstates churn early in the month
Are discounts in MRR?Yes, MRR is what customers actually payOtherwise MRR doesn’t match revenue
Are paused subscriptions active?No, show them separately as MRR on holdHides real churn if counted as active
How are trials treated?Outside MRR until the first paymentTrials inflate MRR and then fall out
What currency?One reporting currency with a fixed rate per monthExchange rates otherwise move MRR on their own

Show the rule in the definition tooltip of each metric. When someone asks “why is churn higher than last month?”, the answer should be on the screen.

Building it with an AI agent

With the Ingot UI MCP server connected, an AI coding agent can build these pages from the Vantage system instead of inventing its own cards and colours:

Prompt
Using the Ingot UI Vantage system, build app/(app)/subscriptions/page.tsx: KPI strip with MRR, active subscriptions, ARPU and churn vs last month; a 12-month MRR chart with a net movement breakdown; plan mix with price and retention per plan; a past-due stat and a subscriptions table with status, due date, amount and retries; a subscription drawer with change plan, payment link and retry now. Data from lib/data/subscriptions.ts. Include empty and loading states. Run audit_ui at the end.

For setup and more prompts, see Claude Code frontend UI.

Mistakes to avoid on SaaS dashboards

  • Counting annual payments as one month’s MRR. Normalise to monthly and say so.
  • Mixing customer churn and revenue churn. Show both, labelled, because they can move in opposite directions.
  • Showing cumulative totals. “Total customers ever” only goes up and hides churn.
  • Hiding trials in active subscriptions. Show trials separately; they are a pipeline, not revenue.
  • Charts without owners. Every risk list needs an owner column and a next action.

SaaS metrics dashboard checklist

  1. 1MRR, active subscriptions, ARPU and churn in the KPI row, each with a comparison.
  2. 2A 12-month MRR trend plus a movement breakdown (new, expansion, contraction, churn).
  3. 3Plan mix with price and retention per plan.
  4. 4Churn alerts with thresholds, and cancellation reasons with counts.
  5. 5A cohort retention grid with percentages and cohort sizes.
  6. 6A past-due queue with retries and recovery actions in a drawer.
  7. 7An at-risk customer table with an owner for every row.
  8. 8A target with progress and days left.
  9. 9A definition for every metric.

For the general rules behind these pages, read dashboard design best practices. For the time controls, breakdowns and exports these screens rely on, see analytics dashboard design. And for the KPI cards themselves, the KPI card design guide.

Frequently asked questions

What metrics should a SaaS dashboard show?

MRR and net new MRR, active subscriptions, ARPU, customer and revenue churn, cohort retention and past-due revenue. Add a target and an at-risk customer list so the team can act, not just watch.

How do you show churn on a dashboard?

As a rate with a comparison and a threshold alert, next to the reasons customers gave when cancelling. Show customer churn and revenue churn separately, because they can move in different directions.

What is a cohort retention chart?

A grid with one row per signup month and one column per month since signup. Each cell shows the share of that cohort still active, so you can see whether newer customers stay longer.

Should annual plans count fully in MRR?

No. Count one twelfth of the annual price each month and state that in the metric definition, otherwise MRR spikes in the month payments arrive.

Is there a Figma and React kit for subscription dashboards?

Yes. The Vantage system in Ingot UI includes subscriptions, customers, insights and projections pages with KPI rows, retention grids, at-risk tables, drawers and alert components.

About Ingot UI

Ingot UI is a library of nine dashboard design systems built from real product screens. Every generated React component is checked against its Figma original before it ships. How we write guides.

Components in this guide

Keep reading