Plans and versions - Unprice Documentation

A plan is the commercial offer that you sell. A plan version is a dated set of rules for that offer: billing settings, prices, entitlements, meters, limits, and included credits.

Plan: stable identity

Use the plan for the name and stable slug of an offer, such as pro. The plan slug selects the latest published version during customer signup.

Plan version: commercial rules

Use a plan version for the rules that must remain true for a customer after you publish them. A version can contain a billing period, currency, features, usage meters, limits, and credit policy.

Lifecycle

State	Meaning	What to do
Draft	The version is still being configured.	Review its rules before you publish it.
Published	The version can be assigned to customers.	Use it for signup or migration.
Archived	The version is not available for new assignment.	Keep it as evidence for customers who used it.

Change a commercial rule

Create a draft from the current plan.
Change the required price, entitlement, meter, or billing rule.
Review and publish the new version.
Assign or migrate only the customers who should receive the new terms.

This model avoids a request-path branch such as if (plan === "pro"). Your product checks a stable feature slug. Unprice resolves the customer’s plan version and entitlement state. Read Feature types and Usage metering before you publish a usage-based version.