Changing the default Mail Domain in DXP

Issue

Configure the default email domain applied to newly created user environments within Liferay DXP.

Environment

Liferay DXP 7.3+

 

Resolution

Follow these steps:
 

1. Open the Global Menu and navigate to the Control Panel.

2. Click Instance Settings.

3. Select Instance Configuration.

4. Locate the General section.

5. Modify the value within the Mail Domain field.

Additional Information

Impacts of Changing the Mail Domain:

• User Email Addresses: This configuration change affects existing and newly created user accounts. Liferay DXP changes user email addresses automatically to reflect the newly specified domain.

• Notification Templates: Email templates utilized for system notifications or password resets require manual updates to align with the new domain format.

• SMTP Mail Server Configuration: Mail transport settings, including SMTP profiles, must be reviewed to verify compatibility with the modified domain architecture.

• Database Modifications: Underlying identity records are updated dynamically within the system database tables.

• Identity Provider and SSO Integrations: External systems utilizing email attributes for user provisioning, synchronization, or single sign-on (SSO) handshakes must be adjusted.