Skip to main content

Hey, Optimizely X users! Don't waste time looking for resources about Optimizely X Web Experimentation. We've got them for you here

Optimizely Knowledge Base

QA: Whitelist users in an SDK experiment

relevant products:
  • Optimizely X Full Stack
  • Optimizely X Mobile
  • Optimizely X OTT

  • Use whitelists to QA by showing experiments to certain allowed users in SDK experiments

A whitelist is a permissions list that grants certain users access to an experiment. In SDK projects, you can use whitelists to QA by showing published campaigns only to a few, select users.

For example, imagine that you create an A/B test with variation_a and variation_b. You want to show a few key stakeholders the live behavior of those variations, to ensure that they look and work as expected. Use whitelists to show specific users those variations. Users who aren't whitelisted won't see those live variations at all.

When to use whitelists

Use whitelists only for preview, testing, and QA, and for no more than 10 user IDs. Forcing variations with a large number of user IDs will bias your experiment results. 

To target an experiment to a larger group of users, create an attribute for that group and target the experiment to an audience that contains that attribute.

Create a whitelist

Here's how to create a whitelist for an experiment in an SDK project.

  1. Navigate to the Experiments dashboard.

  2. Click the Actions icon () for the experiment. Click Whitelist.

  3. Specify user IDs and corresponding variations you want to force for those users.

    In this example, we forced one visitor into variation_a and two visitors into variation_b.