Individual targeting

Overview

This topic explains how to use a flag's Targeting tab to control which individual contexts receive a variation of a feature flag, based on the context key.

Assigning individual contexts to a variation

The "Targets" section of the Targeting tab allows you to assign individual contexts to a particular flag variation, based on the context key. You can target individual users or any custom context kind that exists in your project.

To assign contexts to a flag variation:

1. Navigate to the flag's Targeting tab.
2. In the "Individual targets" section, click + Add.
3. Choose one or more context kinds and click Save.

4. The "Individual targets" section updates to display the context kinds you selected.
5. Choose contexts to target with the flag variation.

If your application is already sending data back to LaunchDarkly, you can search for any context kind by name or key. These strings are case sensitive.

If you need to target a context that LaunchDarkly doesn't know about, you can enter its key manually. These contexts display in yellow until they encounter a feature flag.

In the screenshot below, specific contexts are receiving the first variation of a flag. That flag is targeted to them. This means that these contexts will receive that flag variation when they access the flag.

Removing individual targets

You can remove a context from a flag's targeting list by clicking the "X" next to the context's name. To do this:

1. Navigate to the flag's Targeting tab.

2. In the "Targets" section, find the name of the context you wish to remove.

3. Click the X next to the name to remove the context:

   

4. (Optional) If you need to undo the changes you just made, click the undo arrow icon to discard all changes:

   

   A "Discard unsaved changes" dialog appears. Click Discard changes to undo all the changes you have made, or Cancel to return to the Targeting tab.

5. Click Review and save.

Scheduling removal dates for individual targeting

You can schedule a removal date and time for each individual context that is targeted by a flag. By doing this, you can specify a future date and time after which the context will no longer be targeted for the specific flag. You can do this when you add a new individual target, or for existing individual targets.

This is useful if you want to give customers trial access to a feature, run a controlled beta test, or just keep your flags organized by not having too many flags working at once.

You can also schedule a context to be removed from a segment, rather than from flag targeting. To learn more, read Scheduling removal from segments.

To schedule a removal date for an individual target:

1. Navigate to the flags list and select the flag for which you want to configure a removal date. The flag's Targeting tab appears.
2. In the "Targets" section, search for the context you want to target or click the name of an existing context you want to set a removal date for.
3. Click Add and schedule removal next to the context name. The "Schedule removal" dialog appears.

4. Set a date and time for the user context to be removed from the flag:

5. Click Save.
6. (Optional) If you need to undo the changes you just made, click the undo arrow icon to discard all changes.
7. Click Review and save.

The individual targets are now scheduled for removal on the date and time you specified.