Skip to content

Overrides

An override gives one Customer a different value of one feature: a trial of a higher limit, a negotiated exception, a design partner’s allowance. It needs no new plan.

  • A time window: starts_at (included) to expires_at (excluded). With no expires_at it lasts until revoked. It can start in the future.
  • Typed: the value must match the feature’s type, for example "unlimited" for a number feature.
  • No overlaps: two overrides of the same feature for the same Customer can’t overlap in time (409).
  • Created or revoked, never edited. To change one, revoke it and create another. Both are recorded in the audit log.

An override replaces the plan’s value only while the Customer’s subscription is eligible. A paused, expired or lapsed subscription grants nothing, override or not.

When an override decides the value, the result says so:

{
"feature_key": "max_projects",
"granted": true,
"value": "unlimited",
"source": "override",
"reason": "customer_override",
"override_id": "a1b2c3d4-…",
"valid_until": "2026-12-01T00:00:00Z"
}

valid_until includes the override’s expiry, and the start of a future override, because the answer changes at those instants with no write.

A common pattern is a time-boxed taste of a higher plan on a Free subscription: overrides with Pro’s values that expire after 14 days. When they expire, the Customer is back on Free values, with nothing to undo.