Skip to content

Model products & features

The catalog is where you describe what you sell. A product carries the features you license; a version lets it evolve without disturbing live customers. This all lives under the Catalog group.

Under Catalog → Products, create a product and give it a name, a code and a version. The code is the stable identifier your integration and API use; the version lets you ship changes deliberately (see Version it below).

A product moves through a lifecycle — keep it in draft while you model it, then publish it when it’s ready to be sold against.

Features are the capabilities you license — each has a dotted code like api-calls.total or export.enabled. Define them once and reuse them.

  • Feature Catalog (Catalog → Feature Catalog, or the product’s Feature Catalog tab) — the definitions: a code, a display name, a data type (boolean, string or numeric) and, for numeric features, a unit.
  • Product Features (the product’s Product Features tab) — which catalog features this product actually offers, and their default values.

Defining a feature in the catalog doesn’t grant anything on its own — it becomes real when a plan sets its value and an entitlement grants it.

For anything you want to count — API calls, exports, render minutes — use the product’s Metering & Monitoring tab. A monitored asset is the meter behind a numeric feature: it’s what usage is reported against and what a plan’s quotas and credits draw down. See Metering, quotas & credits for how the counting and capping work.

When you need to change what a product offers, publish a new version rather than editing the live one. Two things make this safe:

  • Features snapshot at grant. When a product is added to an entitlement, its features are copied in, so later edits never silently change a live customer’s grant.
  • Plans travel with the version. A plan set is scoped to a single product version, so a new version gets its own pricing and the previous version’s pricing is left untouched.

So the clean pattern is: cut a new version, give it its plan set, and grant new entitlements against it — existing customers keep what they had until you renew or migrate them.