# Net revenue retention calculator

- Human page: https://happytails.ai/en/calculators/net-revenue-retention-calculator/
- Markdown: https://happytails.ai/en/calculators/net-revenue-retention-calculator.md
- Structured JSON: https://happytails.ai/agents/en/calculators/net-revenue-retention-calculator/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `net-revenue-retention-calculator` |
| Category | calculators |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Use values for the same period and opening customer group. Enter amounts using a decimal point or your language’s decimal separator, without a currency symbol or thousands separators. Currency is a label, not a conversion. Results use the supplied assumptions and round ratios to six decimal places. Processing stays on your device.

### Inputs and settings

No free-text input is required. Use the file inputs and/or settings below.

| Setting | Meaning | Control type | Default | Constraints |
| --- | --- | --- | --- | --- |
| `startingRevenue` | Revenue from opening customers | text | "10000" |  |
| `expansion` | Expansion from opening customers | text | "2000" |  |
| `contraction` | Revenue lost to downgrades | text | "500" |  |
| `churnedRevenue` | Revenue lost to departing customers | text | "1000" |  |
| `currency` | Currency code | text | "USD" |  |

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Enter amounts in one currency with a decimal point and at most six decimal places. Each input amount may be up to 1,000,000,000,000. Counts are whole numbers up to 1,000,000,000. Results use the supplied inputs and assumptions.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "net-revenue-retention-calculator",
  "category": "calculators",
  "built": true,
  "requirements": "Enter amounts in one currency with a decimal point and at most six decimal places. Each input amount may be up to 1,000,000,000,000. Counts are whole numbers up to 1,000,000,000. Results use the supplied inputs and assumptions.",
  "implementation": {
    "fields": [
      {
        "key": "startingRevenue",
        "label": "Revenue from opening customers",
        "value": "10000",
        "type": "text",
        "inputMode": "decimal",
        "maxLength": 25
      },
      {
        "key": "expansion",
        "label": "Expansion from opening customers",
        "value": "2000",
        "type": "text",
        "inputMode": "decimal",
        "maxLength": 25
      },
      {
        "key": "contraction",
        "label": "Revenue lost to downgrades",
        "value": "500",
        "type": "text",
        "inputMode": "decimal",
        "maxLength": 25
      },
      {
        "key": "churnedRevenue",
        "label": "Revenue lost to departing customers",
        "value": "1000",
        "type": "text",
        "inputMode": "decimal",
        "maxLength": 25
      },
      {
        "key": "currency",
        "label": "Currency code",
        "value": "USD",
        "type": "text",
        "maxLength": 3,
        "autoCapitalize": "characters"
      }
    ],
    "input": false,
    "presentation": "metrics",
    "note": "Use values for the same period and opening customer group. Enter amounts using a decimal point or your language’s decimal separator, without a currency symbol or thousands separators. Currency is a label, not a conversion. Results use the supplied assumptions and round ratios to six decimal places. Processing stays on your device.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 1000000,
      "inputMode": "text",
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 1,000,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Reconcile starting cohort revenue, expansion, contraction and churn to calculate net and gross revenue retention.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

### How to use Net revenue retention calculator

1. Enter recurring revenue from the customer group present at the start of the period.
2. Enter expansion, contraction and churn revenue from that same group, excluding new customers.
3. Calculate net and gross retention and download the reconciliation.

## Useful next steps

- [Churn calculator](https://happytails.ai/en/calculators/churn-calculator/) ([Markdown](https://happytails.ai/en/calculators/churn-calculator.md))

- [Customer acquisition cost calculator](https://happytails.ai/en/calculators/customer-acquisition-cost-calculator/) ([Markdown](https://happytails.ai/en/calculators/customer-acquisition-cost-calculator.md))

## Follow the same customer group

Net retention equals opening revenue plus expansion, less contraction and churn, divided by opening revenue. New-customer revenue is excluded. With opening revenue of 10000, expansion of 2000, contraction of 500 and churn of 1000, net retention is 105%.

### Keep gross and net retention separate

Gross retention excludes expansion. In the example it is 85%, making the revenue lost before expansion visible. Contraction and churn cannot together exceed opening cohort revenue in this model. Keep the revenue definition and observation period consistent.