Email Queue Stuck in "Not Sent" Despite Successful Communication Creation

Environment:

  • Frappe: 16.18.2

  • ERPNext: 16.18.3

Issue:

When creating a Communication record with email recipients, the Communication document is saved successfully and an Email Queue record is created.

However, the email is never sent to the recipient and the Email Queue status remains “Not Sent”.

Observed Behavior:

  1. Communication document is created successfully.

  2. Email Queue entry is generated.

  3. Email Queue status remains “Not Sent”.

  4. Email is never delivered to the recipient.

  5. No obvious SMTP error is displayed in the UI.

  6. Repeated scheduler execution does not send the email.

Expected Behavior:

  1. Communication should create an Email Queue entry.

  2. Scheduler should process the Email Queue.

  3. Email Queue status should change to “Sent”.

  4. Recipient should receive the email.

Additional Information:

  • Email Account is configured and enabled.

  • Outgoing SMTP settings are configured.

  • Communication records are created without errors.

  • Only email delivery is failing.

  • Looking for debugging steps to identify why Email Queue records remain in “Not Sent” status.

Questions:

  • What are the common reasons for Email Queue entries staying in “Not Sent” status?

  • Which logs should be checked to identify the root cause?

  • Is there any known issue in Frappe/ERPNext v16 related to Email Queue processing?

Hi @Meet-Tank4

If you see at the top admin@example.com has not been properly linked to your email

Try this - in the email account you want to send make sure these 3 are ticked under outgoing (SMTP) settings: -
a) Enable Outgoing
b) Default Outgoing
c) Always use this email address as sender address

Hope it helps

Thank you

1 Like