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

Revvly · documentation

# Orchestrate the flow of *revenue*.

An interactive reference for subscriptions, pricing, billing, and analytics inside Revvly. Click any node to jump to its concept page.

These docs cover the revenue core — catalog, pricing engine, subscriptions, usage ingestion, invoicing, and the analytics that derive from them — plus the CRM add-on that feeds new business into it, from prospect to signed customer. Dashboard-first surfaces (team management, onboarding, integrations settings) are documented in-app.

Quickstart ›

Follow the Acme Corp example

Jump to Subscription

Jump to Variable Component

Catalog & pricing

Built and priced once, up front

The subscription

Pins versions, resolves the price

Billing & analytics

What happens next

RegionA geographic market you sell into, with its own currency.

Feature FlagThe smallest switch — a single capability that's on or off.

MeterThe definition of something you meter — seats, GB, API calls, GMV.

Variable ComponentA versioned, priced rule attached to a Meter — flat, tiered, overage, commission.

ModuleA versioned bundle of Feature Flags and Variable Components.

BundleA versioned package of Modules sold at a single tier — Starter, Pro, Enterprise.

Variable Component PriceA scoped, multi-currency price for a Variable Component.

Custom Pricing AgreementA negotiated per-customer override for a single Variable Component.

ClientYour customer — the company you're selling to.

SubscriptionThe agreement — one customer, one plan, on a cadence, pinned to specific versions.

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

InvoiceA billing document issued to a customer.

DiscountA bounded, reversible price reduction — reusable template or one-off.

Lifecycle EventAn immutable record of every revenue-moving moment.

Everything below lives inside one

Tenant ›

Pin

The subscription pins the catalog

A Subscription pins specific `(componentId, componentVersion)` tuples and resolves their scoped price — the catalog and pricing are built once, then referenced.

⇄**Exchange rates**Pulled daily. Subscriptions store the rate they used.

Bottom-up

### Every sale is a stack.

Feature Flags and Meters are the atoms. Variable Components wrap a pricing model around a Meter. Modules and Bundles compose Components into versioned plans. Subscriptions pin specific versions. Custom Pricing Agreements override a single component for a single customer. Everything writes events as it moves.

L

7

The log of truth

Analytics read from here

Lifecycle EventAn immutable record of every revenue-moving moment.

InvoiceA billing document issued to a customer.

L

6

The agreement

One customer, one plan, pinned versions

ClientYour customer — the company you're selling to.

SubscriptionThe agreement — one customer, one plan, on a cadence, pinned to specific versions.

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

L

5

The private deal

Per-customer override at next renewal

Custom Pricing AgreementA negotiated per-customer override for a single Variable Component.

L

4

The price tag

Variable Components priced per scope

Variable ComponentA versioned, priced rule attached to a Meter — flat, tiered, overage, commission.

Variable Component PriceA scoped, multi-currency price for a Variable Component.

RegionA geographic market you sell into, with its own currency.

L

3

The package

Versioned plans customers buy

BundleA versioned package of Modules sold at a single tier — Starter, Pro, Enterprise.

L

2

The capability

Versioned groups of flags + components

ModulemanyA versioned bundle of Feature Flags and Variable Components.

L

1

The atoms

Switches and metrics

Feature FlagmanyThe smallest switch — a single capability that's on or off.

MetermanyThe definition of something you meter — seats, GB, API calls, GMV.

↑

Built once, sold many times.

You configure the bottom four layers during onboarding. The top three happen every time a customer signs, upgrades, renegotiates, or renews.

The revenue engine

### Inputs feed in. *Revenue* flows out.

Your catalog is the raw material. The Subscription & Pricing engine processes it. Invoices, events, and analytics are the exhaust — the record of what happened.

Inputs · catalog

Feature Flag

Meter

Variable Component

Module

Bundle

Region

THE HUBSubscriptionWho, what, how much, how often.

Component Pricescoped, versioned, per-currency

Clientthe customer

Expansionmid-cycle changes

Outputs · what you see

InvoicesBilling documents, line items.ACME-2026-04-0007 · $67.33

Lifecycle EventsAppend-only log. Source of truth.EXPANDED · +$25 MRR

Analytics

MRR, ARR, NRR, churn — all derived.

MRR

$12,540

ARR

$150,486

Net churn

2.4%

All of the above is scoped to your **Tenant** — your slice of Revvly. No one else sees it.›