This documentation is for WSO2 Identity Server 5.0.0. View documentation for the latest release.
Page Comparison - Adding New Claim Mapping (v.3 vs v.4) - Identity Server 5.0.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Sign in to the management console by entering your username and password.
  2. Click the Configure button to access the Configure menu.
  3. In the Configure menu, select Claim Management.
  4. Click on any available dialect link.
  5. Click on the Add New Claim Mapping link.
  6. Enter the required information:

    • Display Name - Name of the claim displayed on the UI.
    • Description - Describes the functionality of the claim.
    • Claim Uri - URI defined under the dialect, specific to the claim.
    • Mapped Attribute - Corresponding attribute name from the underlying user store. When you have multiple user stores connected to the Identity Server, this maps the attributes in all of them to the Claim Uri you are configuring. If you want to specify the attribute in a specific user store, you must add the domain name in addition to the mapped claim. For example, in a scenario you have a primary user store configured called PRIMARY and secondary user stores called AD (representing Active Directory) and JDBC, you can map an attribute from each of these user stores to the Claim Uri. In this scenario, your Mapped Attribute value would read as follows: PRIMARY/attribute1;AD/attribute2;JDBC/attribute3.
    • Regular Expression - Regular expression to validate inputs.
    • Display Order - Display order of the claim among the other claims defined under the same dialect.
    • Supported by Default - If unchecked, this claim will not be prompted during user registration.
    • Required - Whether this claim is required for user registration.
  7. Click on the Add button.
  8. A new claim mapping is displayed in the list.