Skip to main content

Strategy Constraints

Strategy constraints allow you to set pre-conditions on activation strategies that needs to be satisfied for the activation strategies to take effect.

Constrain on a specific environment#

The most common use case for strategy constraints is that you want an activation strategy to only take effect in a specific environment. For example, you could enable the feature for everyone in development, while you only expose the new feature to a few percent of users in production.

Strategy constraints

Constrain on custom context fields#

It is also possible to constrain an activation strategy configuration on custom context fields. A common use case is a multi-tenant service where you want to control roll-out on a tenant identifier. This allows you to decide which customer should get access to your new feature.

Custom constraints

Define your own custom fields#

Starting with Unleash-enterprise version 3.2.28 customers can define their custom context fields via the user interface.

You can also define your own custom context fields that you can use together with strategy constraints. We have seen customers use multiple variants of custom context fields to control their feature roll-out:

  • region
  • country
  • customerType
  • tenantId

Combining strategy constraints with the “flexibleRollout” allows you to do a gradual roll-out to a specific segment of your user base.

Step 1: Navigate to “Context Fields“#

Locate “context fields in the menu

Context fields

Step 2: Define new context field#

Next you can define your new context field. The minimum requirement is to give it a unique name. In addition, you can give it a description and define the legal values.

New context fields

What is “legal values”?#

Legal values defines all possible values for the context field. this will be used in Unleash Admin UI to guide users when working with context fields to make sure they only use legal values.

New context fields