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

GIVE DOCS FEEDBACK

Bulk targeting

Read time: 4 minutes
Last edited: May 01, 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 targets for a single feature flag variation. You can use bulk editing with the "user" context kind to make changes to users in large numbers, such as adding or removing them to 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

Very large lists of named contexts increase the size of the payload the SDK fetches when initializing, as well as the memory footprint of the SDK. If you use big segments, you may have lists of over 15,000 contexts, which can increase initialization time. To learn more, read Segments.

We recommend not exceeding a few thousand individual contexts across your flags and segments. Instead, use context attributes to target a large number of individual contexts. You can assign an attribute to the contexts that should receive the feature flag and then set up the targeting rules to serve the flag to contexts with that attribute, so you can target groups of contexts without increasing the size of the payload.

To learn more, read Context attributes.

Bulk edit targets

If you have a long list of contexts you want to add, remove, or replace within a segment, 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.