.. _pilot_users:

Pilot Users
^^^^^^^^^^^

:supported-text:`Supported on` |ios-logo| |android-logo| |rest-logo| |react-logo| 
|js-logo|

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 :code:`setup()` or as soon as
the ID is known by the device.

.. tabs::
   .. code-tab:: java Android (Java)
      :caption: Android (Java)

      Apptimize.setPilotTargetingId("1234");
      
   .. code-tab:: objectivec iOS (Objective C)
      :caption: iOS (Objective-C)

      [Apptimize setPilotTargetingID:@"1234"];

   .. code-tab:: swift iOS (Swift)
      :caption: iOS (Swift)

      Apptimize.setPilotTargetingID("1234")

   .. code-tab:: javascript JavaScript
      :caption: JavaScript

      Apptimize.setPilotTargetingId("1234");


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.

.. image:: pilot-users/Pilot-Group.png

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

.. include :: /_res/replace/icons.rsti