Custom rules

Overview

This topic explains how to use custom rules to target contexts based on their attributes.

Target contexts with custom rules

You can create custom targeting rules using any context kinds and any context attributes.

To create a custom targeting rule:

1. In the flags dashboard, scroll or search to find the flag you want.
2. Click the flag's name to open the flag's Targeting tab.
3. Click the + Add rule button, or + between existing rules, and select "Build a custom rule":

4. (Optional) Enter a name for the rule.
5. Select an option from the Context kind menu:

• Choosing a specific context kind lets you target on attributes for contexts of that kind.
• Choosing "Context kind" lets you target one or more context kinds. If you choose "Context kind," skip to step 5.
• Context kinds are included in this menu after either you create them from the Contexts list or evaluate a context using a LaunchDarkly SDK.

6. In the Attribute menu, select one of this context's attributes.
7. In the Operator menu, select the operator for your clause.
8. In the Values menu, enter one or more values to check against.
9. (Optional) Click the + to add additional clauses to your targeting rule.
10. In the Rollout field, select the variation to serve, or set a percentage rollout.
11. (Optional) Click + Add rollout to create a progressive rollout or guarded rollout for this rule.
12. Click Review and save.

If a targeting rule references any context kinds or attributes with null values, or that do not exist for a given context, then the flag skips that rule. For example, in a rule that checks "region is one of Canada," any context whose region attribute is not set or is set to null does not match the rule. Similarly, in a rule that checks "region is not one of Canada," any context whose region attribute is not set or is set to null does not match the rule. This behavior ensures that your rules only target contexts for which you explicitly have attribute information.

Multiple conditions and values

You can add multiple conditions to a rule. Here is how rules handle multiple conditions and values:

• Contexts must meet all the conditions in a rule to match the rule. If any of the conditions are not met, the context will not match the rule.
• If a condition has multiple values, LaunchDarkly considers the condition met if there is a match on any of the values.
• If an attribute has an array value, LaunchDarkly treats it as multiple values and allows any of the values within the array to match a rule.

To reference this rule when working with other members of your organization, click the three-dot overflow menu and choose Copy link to rule.