Pilot Users

Please note that Pilot Users and Groups only work when using our client-side SDKs (Android, iOS, JavaScript, and React Native). Pilot Users are not currently available on our server-side SDKs, REST API, or Roku.

Pilot users are specific users (internal, beta users, press, etc.) that are granted early or guaranteed access to a feature or experiment. In order to enable this feature, you must set the “PilotTargetingID” via our API. This is typically the userID you use internally. We recommend setting the Pilot Targeting ID immediately after calling Apptimize setup() or as soon as the ID is known by the device.

iOS (Objective-C)
[Apptimize setPilotTargetingID:@"1234"];
iOS (Swift)

Note that pilot users are independent of all other feature flag controls. Meaning, if you want to target a feature only to pilot users, you launch the feature flag or experiment with your allocation percentage set to 0%. This ensures no additional randomly selected users will see the feature. Pilot users will also always see the feature flag, regardless of whether they meet other specified targeting or version criteria.

To add an individual user, specify the user ID (required). You can also specify the user’s name (optional) for referenceability. Only the user ID is used to determine the specific user to target.


It’s also possible to create and edit groups of users manually or via .csv upload by clicking on “create a group”. See User Groups for more information. Any previously created groups will be available in the dropdown for use with Feature Flags.