Skip to content

Email Configuration

Email Configuration is where you configure the SMTP server that ShipEdge uses to send automated emails. This configuration is essential for the system to send notifications, confirmations, alerts, and other automated emails to your customers and users.

Without correct SMTP configuration, automated emails will not be sent and you’ll lose important communication with your customers.


Functional Automated Emails

Configure the SMTP server so all system automated emails are sent correctly to your customers and users.

Reliable Notifications

Ensure important notifications (orders, inventory, shipments) arrive on time to the correct recipients.

Professional Branding

Define the name and email address from which emails are sent to maintain brand consistency.

Test Before Using

Test the SMTP configuration before activating it to verify everything works correctly.


  1. Navigate to Configuration Menu

    Go to the main menu and select the configuration or administration section.

  2. Select Email Configuration

    Click Email or Email Configuration from the menu. The page will open with two tabs:

    • Email configuration: SMTP server configuration
    • Wall communication: Wall notification configuration
  3. Configure the SMTP Server

    If it’s the first time, you’ll see a form to configure the SMTP server. If already configured, you’ll see fields to update the configuration.


The “Email configuration” tab contains all fields necessary to configure the SMTP server:

SMTP server

SMTP Server: Outgoing mail server address.

Common examples:

  • Gmail: smtp.gmail.com
  • Outlook: smtp-mail.outlook.com
  • Yahoo: smtp.mail.yahoo.com
  • Own server: mail.yourdomain.com

Format: Plain text (example: smtp.gmail.com)

SMTP port

SMTP Port: Port used by the SMTP server for secure connections.

Common ports:

  • 465: SSL/TLS (recommended for Gmail and many providers)
  • 587: STARTTLS (common alternative)
  • 25: No encryption (not recommended, may be blocked)

Format: Number (example: 465)

SMTP username

SMTP Username: Username or email address for authentication.

Examples:

  • Gmail: youremail@gmail.com
  • Outlook: youremail@outlook.com
  • Own server: user@yourdomain.com

Format: Email address or username

SMTP password

SMTP Password: Password for SMTP server authentication.

Note for Gmail: If you use Gmail, you need to generate an “App Password” instead of your normal password. Go to your Google account → Security → App passwords.

From name

Sender Name: Name that appears as sender in sent emails.

Examples:

  • “Your Company”
  • “ShipEdge Warehouse”
  • “Technical Support”

This is the name recipients will see in their inbox.

From email

Sender Email: Email address from which emails are sent.

Format: Must be a valid email address (example: noreply@yourdomain.com)

Important: This address must be authorized on your SMTP server. Some servers require it to match the SMTP username.


How to Configure Email Configuration for the First Time

Section titled “How to Configure Email Configuration for the First Time”
  1. Access Email Configuration

    Go to the menu and select Email Configuration. If it’s the first time, you’ll see an empty form.

  2. Complete SMTP Fields

    Enter your SMTP server information:

    • SMTP server: Server address (example: smtp.gmail.com)
    • SMTP port: Server port (example: 465 for SSL)
    • SMTP username: Your username or email
    • SMTP password: Your password or app password
  3. Configure Sender

    Define how emails will appear:

    • From name: Name recipients will see
    • From email: Address from which emails are sent
  4. Save Configuration

    Click Save to save the configuration. The system will save the values and display them in the edit form.

  5. Test Configuration

    Use the “Test configuration” function to verify everything works correctly before using the system in production.


  1. Access Email Configuration

    Go to Email Configuration. If already configured, you’ll see fields with current values.

  2. Modify Necessary Fields

    Update any field you need to change:

    • You can change server, port, username, or password
    • You can modify sender name or email
    • For password: If you see asterisks (*), leave them if you don’t want to change it. Only enter a new password if you want to update it.
  3. Save Changes

    Click Update to save modifications. Changes will apply immediately.

  4. Test New Configuration

    Use the test function to verify the new configuration works correctly.


After configuring or updating SMTP, you should always test that it works:

  1. Locate “Test configuration” Section

    At the bottom of the Email Configuration form, you’ll find the “Test configuration” section.

  2. Enter Test Email

    In the To email field, enter an email address to which you want to send the test email (can be your own email).

  3. Click “Test”

    Click the Test button. The system will attempt to send a test email using the current SMTP configuration.

  4. Verify Result

    You’ll see a message indicating if the email was sent correctly:

    • Success: “An email will be sent to [email]”
    • Error: “Please update SMTP credentials and try again”
  5. Check Your Inbox

    If the message indicates success, check the inbox (and spam) of the test email to confirm you received the email.


The second tab “Wall communication” controls email notifications related to the Wall (internal communication system):

Send emails

Send Emails: Controls when emails related to the Wall are sent.

Options:

  • Disabled: No Wall emails are sent
  • New posts: Emails sent only when there are new posts
  • New posts and replies: Emails sent for new posts and replies

Recommendation: Use “New posts and replies” to keep users informed of all relevant activity.

Notification emails

Notification Emails: Email addresses that will receive Wall notifications.

Format: You can enter multiple addresses separated by commas (example: admin@company.com, manager@company.com)

Usage: These addresses will receive emails when there’s new activity on the Wall according to the “Send emails” configuration.

  1. Open “Wall communication” Tab

    Click the Wall communication tab in Email Configuration.

  2. Select Sending Option

    Choose when you want emails to be sent:

    • Disabled: Disable Wall emails
    • New posts: Only new posts
    • New posts and replies: Posts and replies
  3. Enter Notification Addresses

    In the Notification emails field, enter the email addresses that should receive notifications (separated by commas if multiple).

  4. Save Configuration

    Click Save (first time) or Update (if already configured) to save changes.


Recommended configuration:

  • SMTP server: smtp.gmail.com
  • SMTP port: 465 (SSL) or 587 (STARTTLS)
  • SMTP username: Your complete Gmail address
  • SMTP password: App password (not your normal password)
  • From email: Must be your Gmail address

How to get app password:

  1. Go to your Google account → Security
  2. Enable two-step verification if not enabled
  3. Go to “App passwords”
  4. Generate a new password for “Mail”
  5. Use that password instead of your normal password

Recommended configuration:

  • SMTP server: smtp-mail.outlook.com or smtp.office365.com
  • SMTP port: 587 (STARTTLS)
  • SMTP username: Your complete Outlook address
  • SMTP password: Your Outlook password
  • From email: Your Outlook address

General configuration:

  • SMTP server: Address provided by your hosting provider
  • SMTP port: Generally 465 (SSL) or 587 (STARTTLS)
  • SMTP username: Username provided by your hosting
  • SMTP password: Password provided by your hosting
  • From email: Must be a valid address on your domain

Consult with your hosting provider to get exact values.


Use SSL/TLS

Always use encrypted ports (465 or 587) to protect your credentials and sent emails. Avoid port 25 without encryption.

Test After Changes

Always test configuration after making changes, especially if you update the password or change servers.

App Passwords

For Gmail and some providers, use app passwords instead of your main password. This is more secure and avoids authentication problems.

Valid From Email

Make sure the “From email” is a valid and authorized address on your SMTP server. Some servers reject emails if it doesn’t match the SMTP username.

Monitor Emails

After configuring, monitor that automated emails are being sent correctly. Check recipient inboxes and spam folders.

Document Configuration

Save SMTP configuration information in a secure place (not in public documentation). This helps if you need to reconfigure later.


Possible Causes:

  • Incorrect SMTP credentials (username or password)
  • Incorrect port for the server
  • SMTP server blocked by firewall
  • Gmail password is not an app password
  • Server requires different authentication

Solution:

  1. Verify SMTP server and port are correct for your provider
  2. Confirm username and password are correct
  3. For Gmail, make sure to use an app password, not your normal password
  4. Verify there’s no firewall blocking the SMTP port
  5. Try an alternative port (465 vs 587)
  6. Contact your email provider if the problem persists

Possible Causes:

  • “From email” is not verified on SMTP server
  • Missing SPF/DKIM configuration on domain
  • SMTP server has poor reputation
  • Email content triggers spam filters

Solution:

  1. Verify “From email” is authorized on your SMTP server
  2. Configure SPF and DKIM records on your domain (consult with your hosting provider)
  3. Use a reliable SMTP server with good reputation
  4. Review email template content to avoid words that trigger filters
  5. Consider using a professional transactional email service (SendGrid, Mailgun, etc.)

Possible Causes:

  • Incorrect password
  • Incorrect username
  • Server requires different authentication
  • Account locked due to failed attempts

Solution:

  1. Verify username and password are exactly correct (no extra spaces)
  2. For Gmail, generate a new app password
  3. Verify account is not locked (check provider email)
  4. Try logging into the mail server directly to confirm credentials
  5. Contact your email provider support if the problem persists

Problem: “Emails are sent but don’t arrive”

Section titled “Problem: “Emails are sent but don’t arrive””

Possible Causes:

  • SMTP server accepts email but doesn’t deliver it
  • Email is in recipient spam folder
  • Destination address is incorrect
  • Destination server rejects the email

Solution:

  1. Verify destination addresses are correct
  2. Check recipient spam folders
  3. Verify SMTP server logs if you have access
  4. Try sending to different addresses to isolate the problem
  5. Contact SMTP server administrator to review delivery logs

Can I use any SMTP server?

Yes, as long as you have correct credentials and the server allows external connections. Some servers require additional configuration (IP whitelist, etc.).

Do I need to change configuration if I change email providers?

Yes, you need to update SMTP server, port, username, and password when changing providers. Don’t forget to test the new configuration.

What happens if I don’t configure Email Configuration?

Without SMTP configuration, the system won’t be able to send automated emails. Notifications, confirmations, and alerts won’t be sent to recipients.

Can I use multiple SMTP servers?

Current configuration allows only one SMTP server at a time. All automated emails will use the same configuration.

Do changes apply immediately?

Yes, changes are saved immediately when you click “Update” or “Save”. Next automated emails will use the new configuration.

What is an app password?

An app password is a special password generated by your email provider (like Gmail) that allows external applications to access your account without using your main password. It’s more secure and often required for services like Gmail.


Explore Related Features: