> ## Documentation Index > Fetch the complete documentation index at: https://docs.beaconrevenue.io/llms.txt > Use this file to discover all available pages before exploring further. # Read your revenue page > Every control on the Revenue page and what it does, which controls are switched off today and why, and where each figure's definition lives. Revenue shows the recurring revenue Beacon reads from your billing system, month by month. **Nothing on this page is worked out by the page.** No total, no average, no growth rate is calculated on screen. Every figure arrives already calculated, and where Beacon has not produced one, the page says so and adds nothing up in its place. ## Before any figure — the status line Above everything there is a line saying whether Revenue data is switched on for your company, and the date the figures behind it were last read. It comes first on purpose. A figure without the state of the thing that produced it is a figure you cannot judge. If the page can show nothing at all — your billing system is not connected, or Revenue has not been switched on for your company — it says that **once**, under the status line, and draws nothing else. That is a hard stop, not an empty period: with no billing there is no recurring revenue to show. ## Two views | Tab | What it draws | | - | - | | **Regular** | Your company as a whole, month by month | | **Comparative** | The same charts as one line per segment, country or product — each with its own forecast, one comparison at a time, everything in one reporting currency | Comparative is present and its charts are not drawn yet. The page says why: comparing needs your customers grouped by segment, country or product, which Beacon does not do yet. ## The control rows Three rows sit under the tabs. A control that has nothing behind it yet is **shown, switched off, with the reason beside it** — rather than hidden, so you can see what the page will do and what it cannot do today. ### Filters In **Regular** this row is `Segment is …`, **+ Add filter** and **Clear all**. In **Comparative** it becomes **Compare by** — Segment, Country or Product — and **Narrow**. All of it is switched off today, with one reason on screen: segment, country and product switch on once Beacon groups your customers by them. ### Reporting period This row is live and it is the one that changes what you see. | Control | What it does | | - | - | | **Actuals through** | The last month treated as settled. Every month after it is forecast | | **Reporting period, from → to** | The span the charts and the table cover | | **By: Month / Quarter** | Month is the only granularity today | | **Apply** | Re-reads Beacon for exactly the months you asked for | **Quarter is shown and switched off**, with its reason: quarterly views arrive when Beacon provides quarterly company figures. Grouping months into quarters would mean adding revenue values together on the screen, which this page never does. The period lives in the page address rather than in the browser, so a period you choose survives a reload and can be sent to someone else as a link. One thing to know: changing the period returns you to the **Regular** tab, so re-pick Comparative after you apply. ### Compare with Two dropdowns, both switched off. The reason on screen: nothing to compare with yet — add a budget or save a forecast and it appears here. ## The four tiles Four company figures for the month you set as **Actuals through**: | Tile | What it is | | - | - | | **Recurring revenue (MRR)** | The contracted amount that repeats, normalised to a monthly figure, across every active subscription | | **Annual run-rate (ARR)** | That figure stated annually | | **New MRR** | Recurring revenue that started in the period, from customers with no prior history | | **Churned MRR** | Recurring revenue lost from customers who went to zero | **A tile with no figure says "Not measured" and one sentence saying why — never a dash.** A dash cannot be told apart from a zero, and the difference matters. The reason you are most likely to see: company totals for that month have not been produced yet. Beacon adds them up in its data layer, not on this page, so the tiles fill themselves the day that lands. ## The charts **MRR trajectory** — your company's recurring revenue across the reporting period. Actuals are drawn solid, forecast dashed, and the break is wherever you set **Actuals through**. A month with no stored value stays empty; it is never filled in or carried forward from the month before. **Recurring revenue by subscription** — one line per subscription, as recorded. Four more chart cards are present and not drawn, each carrying its own reason: | Card | Why it is not drawn | | - | - | | **New vs lost this period** | Needs the net change in recurring revenue, which Beacon does not provide yet | | **MRR changes** | The same | | **ARPA** | Beacon does not provide average revenue per account yet | | **MRR by breakdown** | Needs your customers grouped by segment, country or product | The first two are held back for the same reason the page adds nothing up: drawing a net figure would mean the screen working it out. ## The table — Revenue by subscription Every row Beacon holds for the months in your reporting period, as stored. | Column | What it holds | | - | - | | **Month** | Tagged **Actual** or **Forecast**, against your **Actuals through** month | | **Customer** | The customer reference | | **Subscription** | The subscription reference | | **MRR** | Recurring revenue for that subscription, that month | | **ARR** | The same stated annually | | **Movement** | New, Expansion, Contraction, Churn, Reactivation, No change or Inactive | Three things the table will tell you when they apply: * **Future months are real rows, not projections.** An invoice already issued that covers months ahead lands a row in each of those months. The line above the table says how many of the rows fall after your **Actuals through** month and are therefore marked Forecast. * **More than one currency.** Each row is shown as it was recorded. Nothing is converted and nothing is combined. * **More rows than the page reads at once.** Narrow the reporting period to see all of them. ## Where each figure's definition lives Every figure label carries a **?**. It opens a panel with a one-line definition and a link to the full article — the same article, wherever in Beacon you meet that figure. The tiles carry it, and so do the MRR and ARR columns in the table. | Figure | Article | | - | - | | Recurring revenue (MRR) | [How recurring revenue is calculated](/definitions/mrr) | | Annual run-rate (ARR) | [How the annual run-rate is calculated](/definitions/arr) | | New MRR | [What counts as new](/definitions/new-mrr) | | Churned MRR | [What counts as churned](/definitions/churn-mrr) | | Expansion | [What counts as expansion](/definitions/expansion-mrr) | | Contraction | [What counts as contraction](/definitions/contraction-mrr) | ## Two limits worth knowing **Refunds made in Stripe are not read today.** Recurring revenue from Stripe is stated before refunds: a refund by itself does not lower this figure, and Beacon does not estimate the refunded amount. **Payment dates from your accounting system are not used yet.** Receipt timing follows the invoice — when it was issued, when it was due, and when it stopped being open — and the gap between due and paid is not modelled. This one does not change anything on Revenue, which reads billing rather than your books; it is what to know before comparing this page against a cash figure. See [Cash, and how long it lasts](/finance/cash-and-runway). ## Related The answers this page is drawn against, including your reporting currency. What counts, what does not, and how the figure is built. A figure that is missing, switched off, refused or stale. What a settled figure is, and what changes while a period is open. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.