Company Overrides

What are overrides?

In many scenarios customers might need features that don’t come standard in a pre-baked package, such as:

  • A sales-led deal that doesn’t fit perfectly into the good-better-best packages that are on your pricing page
  • Feature trials
  • Testing

In Schematic, we call these “Company Overrides”, and they can be applied individually to any company, or programmatically via our API. We’ll cover both scenarios below.

Override or custom plan?

An override and a custom plan both give one company something its tier does not, so it is worth knowing which one a deal calls for before you start building. Pick based on how much of the deal differs from your catalog.

The dealUseWhy
A standard plan plus one exceptionA company overrideThe company stays on the tier, so later changes to that tier still reach them.
An upgrade motion, where you want a customer to try the tier above theirsA time-limited overrideTurn the premium feature on for two weeks. If they don’t move up, it expires on its own.
A shape that differs throughout: bespoke pricing, a legacy contract, anything that doesn’t map to your catalogA custom planThe company gets its own negotiated plan and its own invoice, billed outside self-service checkout.
Terms everyone should getA new plan versionPublishing a version moves every company on the plan at once, instead of you applying the same override to each of them.

Staying on a standard plan buys the customer something concrete. When you publish a new version of that plan, they get it. A company on a custom plan versions on its own track, so you update them separately from the rest of your catalog.

Applying an override in the Schematic UI

  1. Navigate to a company profile.
  2. Click add override and choose a feature.

Time-limited overrides

While creating an override in the UI, you can also set an expiration date. This is useful for allowing a customer to try a feature for a limited time, often as part of a presale or upgrade motion. Additionally, this can help ease the burden of a pricing migration in which a customer may be losing access to a feature they previously had.

Time-limited override

If you grant additional access to a numeric feature (e.g. seats), when the override expires, the customer will retain their additional usage, but will not be able to add more until they drop below their default plan limit.

Applying an override programmatically

In situations where you may allow the user to enable an individual feature themselves in your application (e.g. trying a specific within their account) or otherwise manage exceptions outside of Schematic (e.g. in Hubspot or your own admin layer), you can use our API to apply the override by using the /company-overrides endpoint.

Here’s an example:

from schematic import Schematic
# initialize the client
client = Schematic(
api_key = "your-api-key"
)
# create company override in Schematic
response = client.entitlements.create_company_override(
company_id= "comp_3bTKVfV6GD1",
feature_id= "feat_FbseajjPuA6",
value_type= "numeric",
value_numeric= 10
)

Once the override is applied via the API, it will also appear in the UI and can be managed within Schematic like other overrides.

Most Generous Policy

In the case that an override provides less quota than a plan entitlement, users will receive the more generous amount.

For example, if a company has a plan entitlement of 1000 API calls, and an override of 500 API calls, the company will receive 1000 API calls.