Source: https://www.revvly.ai/docs/concepts/expansion

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.

Related

Module

Bundle

Subscription

Expansion

Related

Contract

Lifecycle Event

- 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

Effective

Apr 23, 2026