How to change all Confluence internal users e-mail domain name in bulk

Still need help?

The Atlassian Community is here for you.

Ask the community

This guide is tested in Confluence 5.7

This guide is for informational purposes and is not eligible for support from Atlassian.  If you have any questions about the information on this page, please reach out to our community at Atlassian Answers for help. 


When a company get acquired, it is necessary for them to change their e-mail address domain name to the new company. However, Confluence does not have a bulk editing feature that could help simplify this process.


  1. Create a complete database backup for safety precaution.
  2. Execute this SQL query to obtain internal directory id.

    SELECT id FROM cwd_directory WHERE impl_class = '';
  3. Execute the following SQL queries to modified the e-mail domain of your internal users.

    UPDATE cwd_user SET email_address = replace(email_address,'<PreviousDomain>','<NewDomain>') WHERE directory_id = <ID from step 2>;
    UPDATE cwd_user SET lower_email_address = replace(lower_email_address,'<PreviousDomain>','<NewDomain>') WHERE directory_id = <ID from step 2>;
  4. Access Confluence "Cache Management" menu and click "Flush All"
  5. Rebuild search index of Confluence

Extra Notes

This method does not work for external users as Confluence will retrieve the data from the external server configured. Hence any modification in Confluence database will be temporary.



Manage Users

Last modified on Feb 26, 2016

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.