Username preference

Usage By default, WPO365 will take as the username for new users in WordPress the attribute according to the following table.

Option Description
Default If the user is created when they sign in for the first time using OpenID Connect
  • Azure AD The preferred_username which more often than not resembles the user's email address.
  • Azure AD B2C The user's email address.

If the user is created when they sign in for the first time using SAML 2.0

  • Azure AD The user's Microsoft Entra ID user name (= User Principal Name, UPN)
  • Azure AD B2C The user's email address.

If the user is created during WPO365 User synchronization

  • WPO365 will choose the value you defined for Custom username property (AAD) and which must be a property from this list (make sure to use the beta version of Microsoft Graph, which can be chosen on the plugin's Integration page).
If the user is provisioned by Microsoft Entra ID (SCIM)

  • WPO365 will choose the value you defined for Custom username property (SCIM) and which must be a claim that you have mapped for your application.
Short If selected, WPO365 will take the default value but truncate everything right from the '@' and the '@' itself e.g. john.doe@domain.com becomes simply john.doe (only applies to users created when they first sign in interactively).
Custom If selected, new input fields will appear where you then must enter the ID Token / SAML 2.0 claim, the AAD property and optionally the SCIM attribute that WPO365 should use as a username, as follows.

If the user is created when they sign in for the first time using OpenID Connect / SAML 2.0

  • WPO365 will take the value you entered for Custom username claim (ID token / SAML response)

If the user is created during WPO365 User synchronization

  • WPO365 will take the value you entered for Custom username property (AAD)

If the user is provisioned by Microsoft Entra ID (SCIM)

  • WPO365 will take the value you entered for Custom username property (SCIM)


Please note Selecting Short is not recommended, if users sign in from multiple domains. In that case there is a significant risk that user john.doe@domain1.com and john.doe@domain2.com will access one and the same account.


Please note When selecting Custom, you must potentially also update the Order for matching users (on the plugin's Single Sign-on page) so that the option Custom is added as the first item.



Default value Default

Path WP Admin > WPO365 > User registration

Versions LOGIN+, SYNC and INTRANET

Visit the website https://www.wpo365.com/

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us