This article provides information about Knack's email delivery history, including details about email rules, scheduled tasks, and how to view the history.
What is the Email History?
Knack maintains a comprehensive record of all emails sent through your form views and scheduled tasks. This feature proves invaluable for verifying successful delivery to recipients, resolving any potential issues with SPAM detection, and more.
Tip: See our guide on emails to learn how to use email rules in your app: Send Emails.
Locating the History
Form Views
You can find the email history in the editor of the form view that contains the email rule.
From the Pages section of the Builder, select your form view to open the view editor and click the "Email Rules" tab. You will find the link labeled "View email delivery history" at the top of the toolbox.
If you do not see the link, it means the view does not have any email rules.
Scheduled Tasks
You can find the email history of any scheduled tasks that send out emails from the "History" tab of the task editor. From the Data section of the Builder, click on the "Tasks" tab in a table menu and click on the task with the email rule.
Navigate to the "History" tab where you will find the task run history. Click on the "View Mail Delivery History" option to access a comprehensive list of all the emails that were sent out.
View the History
Once you've clicked the link, a modal window will appear with a table containing the following columns:
-
Date
-
Recipients
-
Subject
-
Status
Date
The date the email was sent. You can click on the expand icon to view the content of the message (if available).
Recipients
The list of recipients that were sent the email. All recipients (To, CC, BCC) are included in a single comma-separated line.
Subject
The subject of the email. If you use field values, it will show you the full, rendered subject.
Status
The result of the email delivery. It can be one of the following:
|
Status |
Definition |
|
Sending |
The server is in the middle of queueing the email to be sent. |
|
Processed |
The email has reached the queue and is being prepared to be delivered. |
|
Deferred |
The email cannot be immediately delivered, but it hasn't been completely rejected. We will continue to try delivering a deferred email for 72 hours. |
|
Delivered |
The email has been received by the recipient's server. This event does not guarantee that the email was placed in the recipient's inbox. It still needs to go through client SPAM filters, etc. |
|
Dropped |
This event informs you when an email has been dropped. Dropped emails will not be re-sent. If you encounter this status, you should contact our support team immediately for more details. There are a number of reasons your email will not even be sent to a recipient for delivery:
|
|
Bounced |
The server cannot or will not deliver a message. Bounces are often caused by outdated or incorrectly entered email addresses. Many times you won't know a bounced email address until it bounces. Ensure that you have the correct and up-to-date email address to prevent your email(s) from bouncing. |
|
Spam |
The email has been reported as SPAM by the recipient or their email provider. Several SPAM reports may have your account's email privileges revoked; try to avoid sending the same email to these recipients. |
|
Sandboxed |
The email was not sent because the email originated from an account with emails disabled. All emails are sandboxed on Trial accounts. |
Message Body
To see the contents of the email sent from the rule, click on the link in the Subject column. A gray box will show up below with the email body fully rendered.
Notes
-
Currently, email history is not available with emails sent with action links or record rules.
-
Only the most recent 25 records of the Mail Delivery History will be available.
- All emails are sandboxed on Trial accounts.