Variants
How variants model sellable versions of a product.
A variant is a sellable version of a product. Each variant can have one or more prices.
When to use variants
- Plan tiers, such as Basic, Pro, and Enterprise.
- Regional or currency-specific packaging.
- Different included limits or billing options under one product.
- Legacy versions that must remain available for existing customers.
How variants relate to prices
A variant is not itself the charge. Prices define the charge terms. This lets one variant support multiple billing intervals, currencies, or pricing models.
Keep variants stable
Changing a variant affects future catalog behavior. Historic orders and subscriptions should still be understandable from the product, variant, and price context captured at purchase time.
API details are in Catalog API.