The Change Domain feature allows an administrator to update users’ email domains within a HEFLO environment.

This feature is useful when:

• The company changes its email domain (e.g., @company1.com to @company2.com)
• An email infrastructure migration is in progress
• A progressive migration needs to be performed by user groups

Once the modification is completed, users can log in again using their new email address.

🔐 Prerequisites

• You must be an environment administrator.
• The affected users must already exist in the environment.

Accessing the Change Domain Feature

1. Click Manage Environment.
2. Go to the User Authorization page.
3. Open the Users tab.
4. At the top of the table, click the @ (Change Domain) icon.
   
   
   

A window opens displaying:

• A combo box listing the available domains in the environment
• A field for entering the new domain
• A table summarizing the changes

Change the Domain for All Users of a Specific Domain

This method allows you to migrate all users who use a specific domain.

Steps

1. In the Change Domain window, select the current domain you want to modify.
   By default, the first domain in alphabetical order is displayed.
   
    
2. Define the new domain.
3. A summary table will appear showing: 
   • The current email address
   • The new email address
     
     
     
4. Click Confirm.
5. Type the required confirmation phrase and click Yes.
6. A green confirmation notification (toast message) appears if the operation is successful.

The email addresses are updated immediately.

👉 Users can then log out and log in again using their new email address.

Note: This approach impacts only users within the target domain of the environment where the change is implemented.

Change the Domain for a Selected Group of Users

This method allows you to migrate specific users only.

Manual Selection

1. In the Users tab, hold Ctrl.
2. Click the users you want to select.
3. The selected rows will be highlighted in gray. 

   💡 The selection is preserved even if you navigate between pages.

4. Click the @ (Change Domain) icon.

    

5. Review the list of selected users.
6. Define the new domain.
7. Click Confirm.
8. Type the required confirmation phrase and click Yes.

Quick Multi-Selection (User Range)

1. Hold Ctrl + Shift.
2. Select the first user in the range.
3. Select the last user in the desired range.
4. Click the @ icon.
5. Define the new domain.
6. Click Confirm.
7. Type the required confirmation phrase and click Yes.

Best Practices

• Inform users before performing the migration.
• Schedule the operation outside critical business hours.
• Ask users to log out after the update.
• Test with a small group of users first if needed.

Conclusion

The Change Domain feature enables:

• Bulk updates of a specific email domain
• Progressive migration by user selection
• Secure validation before applying changes

It simplifies organizational changes while ensuring control and security of user data.