In confluence how to make users login with their email address rather than username

Would like to know if we can customize the login page so that the users can login to confluence using their email address rather than username.

4 answers

1 accepted

Hi Prasad,

May I know if you configure Confluence to integrate with your LDAP server? If that is the case, you could configure Confluence to acknowledge your user's e-mail address as the user-name by inputting e-mail address parameter as "User Name Attribute".

This way, Confluence will use the registered user's e-mail address as username to access Confluence.

Hope it helps.

Septa Cahyadiputra

Yes, using "User Name Attribute" mail will allow user to login with email (with ldap enabled).

But it looks like sync with ldap is with above setting not longer working (also not if rdn is set to mail).

Has one had same problem and a solution for it ?

Hi Septa,

Sorry for the delayed response. No we don't have a LDAP server. If that is the case we will setup the LDAP server and go with your solution.



It would be useful if Confluence would accept multiple values for login: login name, email address or phone number. Users are used to logging in to other places with their email address so it would save confusion if I could enable multiple options to work.

I agree this would be nice. We do get tickets from time to time from people thinking their company credentials aren't working when really it is just that they entered their full email address instead of just their user name. Switching to use the email address would just result in people having trouble the other way around. Allowing for both options would be ideal.

Allowing only login names is especially a problem when you roll out HipChat as well, which does use an email address!

Or if they have Cloud + Server applications (similar to HipChat).



I don't know if this is still relevant for anyone, but I've written a plugin that allows you to login with either you username or email in Confluence and JIRA Server


I hope its what you need

Aviram, thanks for exploring this via a 3rd party solution. We are currently evaluating the add-on you mentioned but have encountered a few issues (e.g. with the add-on email does work as username but the original username no longer does). That's off topic for this post but I'm still mentioning it here as the related support page ( is currently returning a 404. For those of us interested in the add on how can we interact more with the developers?

Hi Ryan,

Its actually an email address

But feel free to email me directly at for any questions/issues.



Suggest an answer

Log in or Sign up to answer
Community showcase

Scrum Roles Explained: the Do's and the Don'ts

Hello Community,  Today we are going to talk about the three Scrum Roles. There is the Development Team, the Scrum Master and the Product Owner. In my opinion these three are all really impo...

91 views 0 4
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you