Skip to content


Self-registration is an account management feature offered by WSO2 Identity Server.

In this approach, when a user self-registers, a user account gets created and an email requesting for account confirmation is sent to the user's registered email ID. The account remains locked for a predefined duration during which the user should confirm the account creation. If the user does not confirm the account creation before the predefined duration, the user account gets locked. Such accounts can be deleted by administrators to manage resources effectively.


Pickup is a cab company that has many employees who use different credentials to sign in to different internal enterprise applications. While Robert is an administrator at Pickup, Mark is a new recruit who wishes to use the self-registration option to create a user account.

When Mark self-registers, an email requesting for account creation confirmation is sent to Mark's registered email account. Mark should respond to the confirmation email before the confirmation acceptance window expires. If Mark fails to confirm the account creation, the user account will be locked and Robert will be able to delete this user account.

Scenario Diagram

Let's learn how it's done!

Set up

Follow the steps below to configure WSO2 Identity Server to enable password entry for account confirmation.

  1. Open the deployment.toml file in the <IS_HOME>/repository/conf directory.

    1. Make sure the following listener configs are in place.

      priority= "50"
      enable = false
      priority= "95"
      enable = true
      priority= "97"
      enable = true
    2. To send user account creation confirmation email, add the following configurations.

      enable_email_verification = true 
    3. To configure the email server to send emails requesting a password entry, add the following configurations.

      • from_address: This is the email address from which the confirmation email will be sent.
      • username: This is the user name of the given email address.
      • password: This is the password of the given email address.
      from_address= ""
      username= ""
      password= ""
      hostname= ""
      port= 587
      enable_start_tls= true
      enable_authentication= true
      from_address= "[email protected]"
      username= "wso2iamtest"
      password= "Wso2@iam70"
      hostname= ""
      port= 587
      enable_start_tls= true
      enable_authentication= true

      If you are using a Google email account

      Google has restricted third-party applications and less secure applications from sending emails by default. As WSO2 Identity Server acts as a third-party application when sending emails for password entry, follow the steps below to enable your Google email account to provide access to third-party applications.

      1. Access

      2. Under Signing in to Google section, turn off the 2-step Verification option.

      3. Enable Less secure app access in the Google Account's Security section.

  2. Restart WSO2 Identity Server.

  3. Sign in to the WSO2 Identity Server Management Console at https://<SERVER_HOST>:9443/carbon as an administrator.

  4. On the Main menu of the Management Console, click Identity > Identity Providers > Resident.

    Resident menu-item

  5. Under the User Onboarding section, click Self Registration.

    User Self-Registration Option

  6. Enter the required information as given below.

    User Self-Registration form

    1. To enable self-registration, select the Enable Self User Registration check box.

    2. To keep the user account that is created through self-registration locked until the user responds to the account confirmation email, select the Enable Account Lock On Creation Enabled check box.

    3. To enables sending confirmation emails to the user, select the Enable Notification Internally Management check box. If the client application handles notifications, unselect.

    4. You may enter the account confirmation email validity period (in minutes) in the User self registration code expiry time text box.

    5. To set attributes that the user will consent to share:

      1. Click Click here under Manage Self-Sign-Up purposes.

      2. Click Add New Purpose.

        Consent Purpose form

        The Add New Purpose screen appears.

        Add New Consent Purpose form

      3. Enter To send marketing material in the Purpose Name text box.

      4. Enter To send product marketing material via email and text messages in the Description text area.

      5. Under Select PII Categories, click Add PII Category.

        What's PII?

        Personally Identifiable Information (PII) is any information that can be used to identify the user who is consenting to share the user's information. For more information, see Definitions for consent management

      6. Select the following options.


        PII Category entry

      7. Set the First Name and Email display names to mandatory.

      8. Click Finish. Note that the Consent Purposes screen appears.

      9. Click Finish. Note that the User Self Registration screen appears.

  7. Click Update.

You have now configured WSO2 Identity Server to enable self-registration. Let's try it out!

Try out

  1. Access WSO2 Identity Server User Portal at https://localhost:9443/myaccount/.

  2. Click Create Account.

    Register Now option

  3. Enter the user name as Mark and click Proceed to Self Register.

    Start Signing Up form

    Using special characters in the username

    Note that the special characters @, /, \, !, (, ), *, ~, <, >, and whitespaces are not allowed in usernames as they have been reserved for other purposes. See Usernames in WSO2 Identity Server for more information on this.

    The Create New Account screen appears.

    Create New screen

    1. Enter Mark in the First Name text box.

    2. Enter a preferred password in the Password and Confirm password text boxes.

    3. Enter your email address in the Email text box. Note that as per the PII configurations, this text box appears mandatory.

    4. You may enter other details in the given text boxes. Note that as per the PII configurations, those text boxes appear optional.

    5. Read the Privacy Policy and select the Privacy Policy check box.

    6. Click Register.

  4. An email requesting to confirm the user account creation is sent to the given email address.

    Self-Regisrtation Confirmation email

  5. To respond to the account confirmation email, click Confirm Account. A confirmation message appears.

    Account Confirmation notification

  6. Click Close. The WSO2 Identity Server User Portal Login screen appears.

  7. Log in with Mark's credentials and navigate to the Home screen.


Following are more self-registration methods: