Troubleshooting emails

On occasion, parent report emails may fail to be delivered or are blocked from sending. This guide details the various scenarios and suggestions on next steps to resolve.

Email Issues

When viewing a template and term at Reports > Parent Reports, any emails that have failed to send will be indicated in the Email column header as failed, and any that Insight is unable to send as blocked.

Clicking either indicator will automatically apply a status filter for the clicked indicator, and they can also be found as filter options in the Status menu.

Failed - Email has not been delivered

You will see Failed if Insight has tried to send the email, but it has not been delivered.

This could be because Insight received a 'bounce code' from the mail system associated with the email address. These codes represent messages from a mail server to indicate why an email you sent was not delivered. Insight will display this code, and it may help you decide any next steps. There is no guarantee that a code will be returned, so it is possible that an email fails, but Insight is unable to state that it has failed, or why.

The Type will be described as Transient - This is known as a Soft Bounce and may indicate a temporary problem.

The Status code is additional and may provide further detail on the reason for the failure. Not all mail servers provide these codes.

When an email fails, this is usually at the recipient's end. The email has been sent but has not arrived, or been accepted, at the destination.

What can I do to resolve a failed email?

It is worth trying to Resend, using the link next to the Failed indicator. If the problem was temporary, it is likely to work on a resend.

If you have a large number of failed emails, you could filter (by clicking the failed header or through the status menu) then click Resend, in the green bar, to resend all of them. Make sure you apply the failed filter first or this will also resend all the other emails too.

The Status code may provide other useful information. The codes and their descriptions are provided at the end of this guide.

If you are unable to resolve the failure, it may be worth checking if the recipient has an alternative email address you could use.

If all else fails, you may need to print the report for delivery.

Blocked - Insight is unable to send further emails to this address

You will see Blocked when Insight is unable to send further emails to that email address.

This could be because you have previously emailed a report to that address, but the recipient has reported it as spam or unwanted.

It could also be because Insight received a permanent bounce code.

Clicking on Blocked will display some more information to help you identify the specific reason for the blockage.

There are three scenarios where Blocked could be displayed:

1. You sent this parent report, the user received it but marked it as spam.

In this case, you will see that the email was sent, so has been received, but Resend is not available as the recipient marked the email as unwanted.

2. You sent a different parent report to this email address previously, and the user marked it as spam.

In this case, the email has not been sent and Insight is currently unable to send to this address.

3. You sent this parent report, it failed to be delivered and Insight received a permanent bounce code.

In this case, you will see both the Failed and the Blocked notification as Insight tried to send the email, but it failed with a permanent bounce code.

What can I do to resolve a blocked email?

When an email address is blocked, Insight will not send emails to that address unless it is reactivated. Clicking the Reactivate link allows you to do this. Once reactivated you will be able to send (or resend) to that address once more.

You should check that the address is correct first, however, and that the recipient wants to receive emails from you. Without further remedial action it is likely that the address will just be blocked again.

It could be that the email address was mistyped or does not exist, and may need amending.

If you're syncing emails from your MIS, remember to amend it there too, or the incorrect email will return on the next sync.

If the recipient confirms that the email is correct, it may be worth double-checking. Can they receive a standard email sent to that exact address, for example?

Email status codes

These codes are externally defined. As such, Insight can display the codes, but we are unable to provide any further support on their diagnosis.




Address does not exist


Other address status


Bad destination mailbox address


Bad destination system address


Bad destination mailbox address syntax


Destination mailbox address ambiguous


Destination mailbox address valid


Mailbox has moved


Bad sender’s mailbox address syntax


Bad sender’s system address


Other or undefined mailbox status


Mailbox disabled, not accepting messages


Mailbox full


Message length exceeds administrative limit.


Mailing list expansion problem


Other or undefined mail system status


Mail system full


System not accepting network messages


System not capable of selected features


Message too big for system


Other or undefined network or routing status


No answer from host


Bad connection


Routing server failure


Unable to route


Network congestion


Routing loop detected


Delivery time expired


Other or undefined protocol status


Invalid command


Syntax error


Too many recipients


Invalid command arguments


Wrong protocol version


Other or undefined media error


Media not supported


Conversion required and prohibited


Conversion required but not supported


Conversion with loss performed


Conversion failed


Other or undefined security status


Delivery not authorized, message refused


Mailing list expansion prohibited


Security conversion required but not possible


Security features not supported


Cryptographic failure


Cryptographic algorithm not supported


Message integrity failure

How did we do?

Powered by HelpDocs (opens in a new tab)