Revvly
Docs
Customers

Expansion

A mid-cycle change — added module, upgraded bundle, raised commitment.

Overview

When a customer changes their subscription between renewals — adds a module, upgrades to a higher bundle version, raises a committed quantity — Revvly records it as an Expansion with a prorated charge or credit. Each Expansion contributes to Expansion MRR, the measure of upsell revenue from existing customers.

How it connects

This concept highlighted in context. Click a peer to navigate.

  • Belongs to one Subscription
  • Emits an EXPANDED or CONTRACTED Lifecycle Event

Key fields

What you’ll see when creating or editing a Expansion.

Subscription
Which subscription changed
Expansion type
Bundle change / Module add / Flag add / Commit raise…
Item + quantity change
What and how much
Prorated amount
Charge or credit for the remainder of the cycle
Effective date
When the change takes effect

Example

Acme · upgrade Pro v1 → v2
Prorated charge$18.33
EffectiveApr 23, 2026