We're rebranding. How do we update all of our user email addresses?

If your organization is rebranding or has updated its email domain, the Greenhouse Technical Support team can assist you with updating all user email addresses in bulk.

How can I bulk update email addresses to a new domain?

Site Admins can update email addresses for multiple users by using the bulk Email Migration Tool under Configure > Email Settings > Bulk Email Migration Tool.

To use this tool, you'll download a .csv of all users in your system, add new emails to the spreadsheet, and upload it. Once the migration is complete, the new addresses will be added as Secondary emails to all affected users.

Once a migration is complete, an email notification will be sent to the submitter's email.

What do users need to do after their email address is updated?

After the bulk update is finished, each updated user will receive an email from Greenhouse to confirm their new email address.

Screenshot-of-verification-link.png

Note: Email addresses can’t be marked as Primary until the new email address is verified. 

Users will need to click the links included in the confirmation email to verify the new email address to leverage communication features such as notifications, reminders, and interview kits within Greenhouse Recruiting.

However, this step isn't required to access Greenhouse Recruiting using the new email address or through Single Sign-On (SSO).

As long as the email address you attempt to log in with matches an email address on your account, you will be able to log in with that address. 

Will these new emails be marked as Primary?

By default, the new email address will be added as a secondary email address on the user's account.

However, if you'd like to set the new emails as Primary for the updated users, include that information in your initial request.

If you elect to use this option, once a user verifies their new email address using the emailed verification link, it will automatically be set as the Primary address on their user account. This Is based on the settings you chose during the migration.

Once the new Primary email has been set, you can then manually remove the secondary email from your Account Settings if it's no longer needed.

To learn more about removing a secondary email from your account, click here.

Note: Users must click the link to verify their new email address within 24 hours of receipt. If a user doesn't click the link within 24 hours, a new link must be sent.

Additional resources