Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polar.sh/docs/llms.txt

Use this file to discover all available pages before exploring further.

Polar ships with a built-in analytics dashboard so you can stay focused on growing the business rather than wiring up reporting. Each section below maps to one of the dashboards on the Analytics page and walks through what its metrics actually mean.

​
How metrics are bucketed

When you pick a date range, Polar splits it into equal-width intervals — one hour, one day, one week, one month, or one year each — and aggregates every metric inside each interval. Each interval (sometimes called a “bucket”) is one point on the chart and one row in the API response.

​
Subscriptions

  • Monthly Recurring Revenue (MRR) — Sum of every active subscription’s amount, normalized to a monthly rate (yearly plans are divided by 12). Trialing subscriptions are excluded.
  • Committed MRR — MRR restricted to subscriptions still inside a committed billing period. Subscriptions that have been canceled but are running out the clock until period end are excluded.
  • Trial MRR Including Canceled Trials — Monthly-normalized amount of every subscription currently in a trial, including trials that have already been canceled.
  • Trial Committed MRR — Trial MRR for trials still inside their committed billing period (i.e. canceled trials are excluded).
  • Active Subscriptions — Count of subscriptions in the active state at the end of each interval. Subscriptions stay active until the end of the period they paid for, even after cancellation.
  • New Subscriptions — Subscriptions whose first paid order falls inside the interval. Each subscription is counted once, at creation.
  • Committed Subscriptions — Active subscriptions that have not been canceled, or whose cancellation date is after the interval. These are the subscriptions you can reasonably expect to renew.
  • Renewed Subscriptions — Number of orders with billing reason subscription_cycle in the interval — i.e. renewals on existing subscriptions.
  • Average Revenue Per User (ARPU) — MRR divided by the count of distinct paying subscribers in the interval (trials excluded). Returns 0 when there are no paying subscribers.
  • Lifetime Value (LTV) — Estimated revenue per customer over their lifetime: (ARPU - cost per user) / churn rate. Returns 0 when churn rate is 0.
  • New Subscriptions Revenue — Gross revenue from the first paid order on every new subscription created in the interval.
  • Renewed Subscriptions Revenue — Gross revenue from subscription renewal orders in the interval.

​
Cancellations

  • Canceled Subscriptions — Subscriptions where the customer triggered a cancellation in the interval. The subscription itself may still be active until the end of the paid period.
  • Churned Subscriptions — Subscriptions whose paid period actually ended inside the interval. This is “real” churn — the moment access stops.
  • Churn Rate — Churned subscriptions in the interval divided by the active subscription base at the start of the interval, expressed as a percentage.
  • Active Subscriptions — Same definition as in the Subscriptions dashboard. Shown here to contextualise churn against the underlying base.
  • Committed Subscriptions — Same definition as in the Subscriptions dashboard.
  • Cancellation reasons — Stacked chart of canceled subscriptions broken down by the reason the customer picked at cancellation: too expensive, missing features, switched service, unused, customer service, low quality, too complex, or other (free-form or no reason given).

​
One-Time Products

  • One-Time Products — Number of completed orders for non-recurring products in the interval. Subscription orders are not included.
  • One-Time Products Revenue — Gross revenue (subtotal before fees) from those one-time product orders.

​
Orders

  • Revenue — Gross revenue from every completed order in the interval: one-time purchases, new subscription orders, and renewal orders. Computed on the order subtotal, before Polar fees and tax.
  • Orders — Total number of completed orders in the interval, regardless of billing reason.
  • Average Order Value (AOV) — Revenue divided by the number of orders. Returns 0 when there are no orders.
  • Cumulative Revenue — Running total of revenue from the start of the selected range up to and including the current interval.

​
Checkouts

  • Checkouts Conversion — Succeeded checkouts divided by total checkouts created, as a percentage. Returns 0 when no checkouts were created.
  • Checkouts — Every checkout session created in the interval, regardless of outcome (succeeded, expired, or abandoned).
  • Succeeded Checkouts — Checkouts that reached the succeeded status, meaning they resulted in an order.

​
Net Revenue

  • Net Revenue — Revenue after deducting Polar’s platform fee and the payment processor’s fee on each order. This is the amount actually paid out to you.
  • Net Average Order Value — Net revenue divided by the number of orders in the interval.
  • Net Cumulative Revenue — Running total of net revenue from the start of the selected range up to the current interval.
  • New Subscriptions Net Revenue — Net revenue from the first paid order on every new subscription. Shown when your organization sells recurring products.
  • Renewed Subscriptions Net Revenue — Net revenue from subscription renewal orders. Shown when your organization sells recurring products.
  • One-Time Products Net Revenue — Net revenue from one-time product orders. Shown when your organization sells one-time products.

​
Costs

The Costs dashboard is powered by Cost Insights — you’ll only see data here once you start sending events with a _cost annotation.
  • Costs — Total operating costs ingested via Cost Insights in the interval. Stored at sub-cent precision so per-event costs (e.g. token-level inference costs) aren’t rounded away.
  • Cost Per User — Cumulative costs in the selected range divided by the count of active subscribers. Returns 0 when there are no active subscribers.
  • Gross Margin — Cumulative revenue minus cumulative costs over the selected range.
  • Gross Margin % — Gross margin expressed as a percentage of cumulative revenue. Returns 0 when cumulative revenue is 0.
  • Cashflow — Revenue minus costs for the interval itself (not cumulative). Useful for spotting periods where costs outpaced revenue.