This documentation is in progress and includes all updates released after Identity Server 5.4.1. For documentation specific to a version, see About This Release.
Page Comparison - Adding Claim Dialects (v.3 vs v.4) - WSO2 Identity Server 5.x.x - WSO2 Documentation

Versions Compared


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


Using the management console

You can define a new claim dialect by clicking on the "Add New Claim Dialect" link. Follow the instructions below to add a new claim dialect.

  1. Sign in. Enter your username and password to log on to the the Management Console.
  2. From the Main menu, click Add under Claims.
  3. Click Add Claim DialectEnter the Dialect URI.


    The Dialect URI is a unique URI identifying the dialect (for example,

  4. Click on the Add button. The claim dialect you added will appear on the list as follows.


  1. Open the claim-config.xml file found in the <IS_HOME>/repository/conf/ folder.  
  2. To add a new claim dialect, add the following configuration to the file along with the new claims you want to add under the dialect. For this example, the new claim dialect is named "SampleAppClaims"

    Code Block
    <Dialect dialectURI="">
            <DisplayName>First Name</DisplayName>
            <DisplayName>Nick Name</DisplayName>
  3. Once you have edited the claim-config.xml file, start WSO2 Identity Server. The configurations will be applied and you can view the new claim dialect in via the management console UI

titleRelated Links

For information on how to add an external claim to this claim dialect, or add a local claim to the wso2 local claim dialect, see Adding Claim Mapping.