A username is the name used to log in to Confluence, for example jsmith. If you are a Confluence administrator you can change a user's username, for example if they change their name.
All active users must have a unique username. This means that two active users cannot have the same username. You can however assign the username of a disabled user to another active user.
The procedure for changing a username depends on where you manage your users. Refer to Configuring User Directories for more information.
Changing the username of a user managed in Confluence
If you manage your users in the Confluence internal directory you can rename your user in Confluence. You will need Confluence Administrator permissions to change a username.
To change a username:
- Navigate to the user's record:
- go to the user's profile and choose Adminster User, or
- go to Confluence Admin > Users and search for the user
- Choose Edit Details.
- Enter the new username and choose Submit.
The user's username has been changed. The user will need to use their new username to log in to Confluence from now on. The new username will also be reflected throughout Confluence, including in user mentions.
Changing the username of a user managed in an external directory
If you do not manage your users in the Confluence internal directory, you may still be able to change a user's username. Confluence cannot update external users but it will detect changes in usernames that are coming from some external directories.
The following table indicates the instances where you may be able to change a username in your external directory and have the change detected in Confluence.
|User directory||Where to rename the user|
|Internal directory with LDAP authentication||
Rename the user in the LDAP directory, Confluence will detect the renamed user.
Note: you must have 'Copy User on Login' enabled. See Copying Users on Login for more information.
|JIRA 6.1 or later||Rename the user in JIRA, Confluence will automatically detect the renamed user.|
|Atlassian Crowd 2.7 or later||Rename the user in Crowd, Confluence will automatically detect the renamed user.|
|LDAP||Rename the user in your LDAP directory, Confluence will automatically detect the renamed user.|
Some important things to note about changing usernames:
- Mentions and page history
Any user mentions in current pages will automatically reflect the user's new username, but any mentions in page versions created prior to Confluence 5.3 will include the user's old username.
- Personal Spaces
If a Confluence Administrator renames a user who has a personal space, the space key for that space will remain the user's original username. For example if jsmith's username is changed to jbrown, their personal space key will remain ~jsmith.
Was this helpful?
Thanks for your feedback!