No results for ""
EXPAND ALL
  • Home
  • API docs

Bulk targeting

Read time: 4 minutes
Last edited: Oct 02, 2024
Bulk targeting is an Enterprise feature

Bulk targeting is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to perform edits on groups of contexts with the "Bulk edit" option, or export all the contexts a flag is targeted to with the "Export as CSV" option.

The bulk edit option lets you manage all of your individual targets for a single feature flag variation. You can use bulk editing with the "user" context kind to make changes in large numbers, such as adding or removing contexts from a flag variation. The export as CSV option lets you export all the context keys for a flag's targeting settings as a spreadsheet.

Bulk targeting limitations

We recommend using individual targeting only for very small numbers of individual contexts. Individually targeting more than 10,000 contexts per environment may cause performance degradation, because the SDK takes longer to initialize when the targeting rules payload is large.

Instead, we recommend using targeting rules or segments to target large numbers of contexts. To learn how, read Custom targeting rules and Segment targeting.

Bulk edit targets

If you have a long list of contexts you want to add, remove, or replace within a individual targeting rule, you can bulk edit these contexts from a flag's targeting page.

To edit contexts in bulk:

  1. Navigate to the Flags list and choose the flag you wish to modify.
  2. Find the individual targeting rule you want to modify and click Edit.
  3. Find the variation you want to edit targets for and click the overflow menu:
The "Individual targets" section with the "Bulk edit" option called out for user contexts.
The "Individual targets" section with the "Bulk edit" option called out for user contexts.
  1. Select Bulk edit. A "Bulk editing" dialog appears.
  2. Choose Add, Remove, or Replace from the menu.
  3. Use the menu to do one of the following actions:
  • "Add" adds the selected contexts as targets to the variation
  • "Remove" removes the selected contexts from the target variation
  • "Replace" replaces all currently targeted contexts with the selected contexts
  1. Enter a list of context keys in the these users field, separated by a comma or new line. LaunchDarkly looks up contexts with a "user" context kind by key and displays them by name in the list on the right. If you want to target a context that has not yet been encountered by LaunchDarkly, you must enter the key.
The "Bulk editing" dialog.
The "Bulk editing" dialog.

You can update the list on the right before you perform the selected action. The options for updating the list include the following:

  • All represents all of the contexts that may be impacted by the action, whether they are added or removed. Check the checkbox for the action to apply.
  • The checkmark represents inputted context keys that currently match contexts in the system. For example, if you enter the key user-key-123-abc, and a user context with that key already exists in LaunchDarkly, it will show up by name in this list.
  • The question mark represents contexts with no matching records in LaunchDarkly. If you are adding contexts and the contexts do not currently exist in LaunchDarkly, they will be added to the targeting list.
  • Current lists all of the currently targeted contexts for the variation.
  1. Click Add N users, Remove N users, or Replace N users to perform the selected action.

If you want to target the same large numbers of user contexts in multiple flags, you can create a segment, set up targeting rules for the segment, and target the segment instead. To learn how, read Segments.

Export a list of contexts to CSV

You can download a list of all the contexts a flag variation is targeted to from the flag's targeting page.

To export a list of contexts to a CSV file:

  1. Navigate to the Flags list and choose the flag you wish to export contexts for.
  2. Find the individual targeting rule you want to export contexts for and click Edit.
  3. Find the variation you want to export contexts for and click the overflow menu:
The "Individual targets" section with the "Export as CSV" option for user contexts called out.
The "Individual targets" section with the "Export as CSV" option for user contexts called out.
  1. Click Export as CSV. A CSV file including the list of contexts keys a flag variation is targeted to downloads to your machine.