Email Logging

SendGrail logs every outgoing email with detailed metadata, delivery status, and optional body content. The email log provides a comprehensive audit trail for troubleshooting and monitoring.

Logged Fields

Every email captured by SendGrail records the following information:

Field	Description
Recipients	All To, CC, and BCC addresses
Sender	From email and display name
Subject	Email subject line
Body	Full email body (when body storage is enabled)
Headers	All email headers
Attachments	List of attached files
Status	Delivery result: sent or failed
SMTP Response	Raw response from the mail server
Error	Error message if delivery failed
Resends	How many times the email has been resent, and when it last went out

Filtering and Search

The email log supports several filtering options to help you find specific emails:

• Status filter -- Filter by sent or failed status
• Search -- Search across recipient email addresses and subject lines
• Date range -- Filter by a custom start and end date

Results are paginated at 20 emails per page.

Email Report View

Clicking on an individual email opens a detailed report with the following sections:

Metadata

Displays the sender, recipients, subject, timestamp, connection used, and all headers.

Delivery Status

Shows the final delivery status along with the SMTP response returned by your provider.

Short responses (such as 250 2.0.0 OK) are shown inline. Longer ones — API providers often return a full JSON payload — are displayed in a response viewer that:

• Pretty-prints JSON with indentation
• Shortens very long values (like an echoed copy of the email body) so the useful fields stay readable
• Offers a Raw toggle to see the untouched response
• Offers a Copy button to put the full raw response on your clipboard
• Collapses tall responses behind a Show more control

The same viewer is used for the SMTP response and headers in the quick-view dialog on the email log list.

Open Tracking Card

When open tracking is enabled, displays the open count and first-opened timestamp.

Click Tracking Card

When click tracking is enabled, displays the click count, first-clicked timestamp, and the list of clicked URLs.

Event Timeline

A chronological list of all events associated with the email: sent, opened, clicked, with timestamps and metadata.

Email Body Preview

The original email body rendered in a sandboxed iframe for safe viewing. This section only appears when body storage is enabled and the email body was captured.

Retention Policy

Email logs can be automatically cleaned up based on a configurable retention period.

• Range: 0 to 365 days
• Cleanup: A daily WordPress cron job removes logs older than the configured retention period
• Setting 0 days: Disables automatic cleanup, retaining logs indefinitely

TIP

Set a reasonable retention period to manage database size. For most sites, 30 to 90 days provides a good balance between auditability and storage.

Resending an Email

Each row in the email log has a Resend button (the paper-plane icon). It sends a copy of that email -- same To recipients, subject, sender identity, and body -- through your current connection.

A confirmation dialog appears first, so a stray click never sends mail.

Once an email has been resent, a small counter appears on the button showing how many times it has gone out again. The exact count and the last-resent timestamp are also shown in the email's detail view.

What happens on resend

• The copy goes through the normal send pipeline, so your routing rules, active connection, and fallback chain all apply. It may therefore leave through a different connection than the original if your configuration has changed.
• The resent copy is recorded as its own new log entry. The original entry only carries the resend counter.
• Tracking is reset. The original email's open and click tracking is stripped from the copy, and the copy gets its own fresh tracking, so resending never inflates the original email's stats.

Limitations

• Body storage must be enabled. Resend needs the stored body to rebuild the message. If the email was logged without its body, the Resend button reports that the body was not stored. See Body Storage below.
• Attachments are not re-attached. The log stores only attachment file names, not the files themselves, so a resent copy goes out without them.
• CC and BCC recipients are not included. Only the To addresses are stored on the log entry, so a resent copy goes only to those.

Bulk Operations

• Bulk Delete -- Select multiple log entries and delete them in a single action
• Clear All -- Remove all email logs at once

WARNING

Deleted email logs cannot be recovered. Use bulk delete and clear all with caution.

Body Storage

By default, email body storage is disabled to protect user privacy and reduce database usage. When disabled, all email metadata is still logged, but the body content is omitted.

To enable body storage, toggle the Store Email Body setting in the plugin settings page.

Privacy Notice

Email bodies may contain sensitive information such as password reset links, personal data, or confidential content. Only enable body storage if your use case requires it and you have appropriate data handling policies in place.