Email Domain
The Email Domain in ERPNext defines the email server configuration used for sending and receiving emails within ERPNext and other Frappe applications.
It acts as a central configuration that simplifies setting up multiple Email Accounts under a single mail server or provider.
What is an Email Domain?
An Email Domain represents the email service or server linked to your business email system.
For example, if your email address is yourname@yourcompany.com, then yourcompany.com is your email domain.
ERPNext can automatically detect the domain when you start configuring an Email Account using an email address.
When Do You Need It?
If you want to send and receive emails directly through ERPNext, you must configure an Email Domain unless you are using predefined providers like Gmail.
For services like Gmail or Yahoo, you usually do not need to manually create a domain, but you must authorize ERPNext access to your account.
Creating an Email Domain
- Go to Email Domain list and click New.
- Enter Example Email Address (e.g., yourname@yourcompany.com).
- Enter Email Server (e.g., mail.yourcompany.com or imap.yourcompany.com).
- Enable Use IMAP if your server supports it for incoming emails.
- Enable Use SSL if your server uses secure communication (HTTPS-based mail access).
- Enable Use SSL for Outgoing if SMTP requires SSL (commonly port 465).
- Enable Append Outgoing Email to Sent Folder if required by your mail server setup.
- Set Attachment Limit (MB) for outgoing emails.
- Enter SMTP Server for outgoing mail.
- Enable Use TLS if supported by SMTP server.
- Set SMTP Port if different from default (25).
After Saving the Domain
Once saved, ERPNext validates the configuration and makes the Email Domain available for selection in Email Account setup.
Validation may take a few seconds depending on server response and connectivity.
Troubleshooting
If setup fails even after correct configuration, verify server credentials, SSL/TLS settings, and firewall restrictions.
Support may be required if the mail server uses custom or restricted configurations.
