URL: /revenue/expansion-arr · Id: `page:/revenue/expansion-arr`

# Upgrades: what moves it

> Upgrades is the ARR gained from Customers who paid in both windows and now pay more.

Upgrades is the ARR gained from [Customers](https://startupbuilder.dev/business/nouns/customer) who paid in both windows and pay more in this one. Grow each Customer moves it.

## The number

```text title="Upgrades · Ask"
What moved upgrades this week, and which Play moved it?
```

```ts title="Upgrades · SDK"
import { $ } from 'startup-builder'

const { total } = await $.Event.list({ where: 'name = "Subscription.resized" and at >= "2026-10-12"', total: true })   // seat and plan changes up
return await $.Metric.query({ metric: 'expansion-arr', shape: 'trend', breakdown: 'play', window: '7d' })   // by the Play credited · Not live yet, gaps #4
```

```json title="Upgrades · Response · sample"
{
  "metric": {
    "$id": "https://api.sb/leaseline.app/metrics/expansion-arr",
    "$type": "Metric",
    "name": "Expansion ARR"
  },
  "week": "2026-10-19",
  "value": 347,
  "rows": [
    {
      "play": "usage-upsell",
      "value": 347,
      "customers": 1
    }
  ]
}
```

`+$347 ARR from upgrades · ■■■■ Clear · n 1 · path → net-new-arr → arr`

`$.Metric.query({ metric: 'expansion-arr', shape: 'trend', breakdown: 'play', window: '7d' })` · sample

| Credited to | This window | Customers |
| --- | --- | --- |
| [Usage upsell](/plays/usage-upsell) | `+$347 ARR` | `1` |

`expansion-arr` is this site’s proposal to the hub (Not live yet, [gaps #4](/code/reference#not-live-yet)), so the figure above is a sample until the hub holds it.

## Owner
| Accountable | From |
| --- | --- |
| [`customer-lead`](https://startupbuilder.dev/agents/customer/customer-lead) · Customer Lead | the filed bridge item, word for word |

## Worked by
| Title | Its queue |
| --- | --- |
| [CSM](/capabilities/how-your-agents-act#csm) | <Op verb="Task.next" /> on the CSM’s queue |

## Moved here by
| How | Where |
| --- | --- |
| Play | [Signal expansion](/plays/signal-expansion) · Shows a growing Customer the seats they already use at the live Price, and names a successor within 5 business days when their champion leaves. |
| Play | [Single sign-on upgrade](/plays/sso-rung) · Answers each single sign-on ask within one business hour with the plan that includes it, and the admin tests sign-in before paying. |
| Play | [Usage upsell](/plays/usage-upsell) · Offers the next Offer when a Customer’s use paces past its Limit, with today’s prorated charge; the Customer upgrades in one press. |
| Page | [More seats and upgrades](/revenue/upgrades-and-seats) |
| Title | [CSM](/capabilities/how-your-agents-act#csm) |

## The leaves
| Under it | Moved by |
| --- | --- |
| `hiring-expansion-arr` | [Signal expansion](/plays/signal-expansion) |
| `limit-upgrade-arr` | [Usage upsell](/plays/usage-upsell) |
| `tier-upgrade-rate` | [Single sign-on upgrade](/plays/sso-rung) |