Skip to main content


Customize an IdP mapping set

For more information, see IdP mapping sets.

  1. Go to Directory > Mapping Sets.

  2. For the relevant IdP mapping set, click Edit.

    For this example, we'll edit our Azure AD mapping set.

  3. Click Change Attributes to go to the Change Attributes (IdP mapping) screen, where you define the attributes that HelloID will pull out of the IdP user schema.

  4. Choose one of the following:

    1. To edit an existing attribute, click Edit.

    2. To add a new attribute, click Add Attribute.


      For this example, we'll add a Mobilephone attribute.

    3. Click Add Attribute to confirm.

      The new attribute is added to the claim set.

    4. Click Close.

    Display Name

    Not used.

    Variable Name

    The intermediary name of the attribute, which will be shown in the User column of the Change Mappings screen, in the next step. Typically should be the same as the Source Field.

    Source Field

    The name of the attribute to pull from the IdP user schema.

    Data Type

    The data type of the attribute.



  5. Click Change Mappings to go to the Change Mappings (IdP mapping) screen.

    In the User column, you specify attributes pulled from the IdP, using their Variable Name. In the HelloID User column, you specify which attribute in the HelloID user schema to map the IdP attribute onto.



    In autocomplete, you have access to attributes defined on the Change Attributes (IdP mapping) screen, as well as Custom variables.

    1. To remap an existing mapping, delete the text in the User field, and then type {{ to activate autocomplete. Select the new mapping.

    2. To add a new mapping, click Add Mapping. Select an attribute in the HelloID User column, and then type {{ in the User field to activate autocomplete.


      For this example, we'll select the user.attributes.[new-entry] option, and change it to This will create a new custom attribute in the HelloID user schema (see Custom user attributes).

      Then we'll map the {{}} attribute onto it (where mobile is the Variable Name we defined on the Change Attributes screen).

    3. Click Close.

  6. Click Save.

The mapping set has been saved, and will now be used for JIT user creation for the associated IdP.