> ## Documentation Index
> Fetch the complete documentation index at: https://docs.migma.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Logs

> View individual email delivery status and tracking data

## Overview

Email logs show the delivery status and tracking data for each email sent from your domain. View logs at **Settings → Sending Domains → \[Your Domain] → Email Logs**.

***

## Log Data

Each email log entry includes:

| Field           | Description                        |
| --------------- | ---------------------------------- |
| **Tracking ID** | Unique identifier for the email    |
| **From**        | Sender email address               |
| **To**          | Recipient email address            |
| **Subject**     | Email subject line                 |
| **Status**      | Current delivery status            |
| **Sent At**     | When the email was sent            |
| **Opened At**   | First open timestamp (if tracked)  |
| **Clicked At**  | First click timestamp (if tracked) |
| **Open Count**  | Total opens                        |
| **Click Count** | Total clicks                       |

***

## Email Status

| Status         | Meaning                                      |
| -------------- | -------------------------------------------- |
| **sent**       | Email accepted for delivery                  |
| **delivered**  | Successfully delivered to recipient's server |
| **opened**     | Recipient opened the email                   |
| **clicked**    | Recipient clicked a link                     |
| **bounced**    | Delivery failed                              |
| **complained** | Marked as spam by recipient                  |

### Status Flow

```
sent → delivered → opened → clicked
            ↓
        bounced
            ↓
       complained
```

An email can have multiple statuses. For example, an email can be:

* `delivered` + `opened` + `clicked`
* `delivered` + `complained`
* `bounced` (never delivered)

***

## Viewing Logs

### List View

The log list shows recent emails with:

* Recipient
* Subject
* Status (with color indicator)
* Sent time
* Open/click counts

### Detail View

Click any email to see full details:

* Complete tracking history
* All timestamps
* Bounce type (if bounced)
* Complaint type (if complained)
* Expiration date

***

## Filtering Logs

Filter emails by:

| Filter         | Options                                               |
| -------------- | ----------------------------------------------------- |
| **Status**     | sent, delivered, opened, clicked, bounced, complained |
| **Date range** | Last 24 hours, 7 days, 30 days, custom                |
| **Search**     | Recipient email address                               |

***

## Bounce Details

When an email bounces, additional details are available:

| Field              | Description                                  |
| ------------------ | -------------------------------------------- |
| **Bounce Type**    | Permanent, Transient, or Undetermined        |
| **Bounce Subtype** | Specific reason (e.g., "General", "NoEmail") |
| **Diagnostic**     | Technical error message                      |

### Common Bounce Types

| Type      | Subtype         | Meaning                   |
| --------- | --------------- | ------------------------- |
| Permanent | General         | Address doesn't exist     |
| Permanent | NoEmail         | Mailbox not found         |
| Permanent | Suppressed      | On suppression list       |
| Transient | MailboxFull     | Recipient's inbox is full |
| Transient | MessageTooLarge | Email too large           |
| Transient | ContentRejected | Content blocked by filter |

***

## Complaint Details

When a recipient marks your email as spam:

| Field              | Description                 |
| ------------------ | --------------------------- |
| **Complaint Type** | Usually "abuse"             |
| **Feedback Type**  | Type of complaint           |
| **Timestamp**      | When complaint was received |

<Note>
  Complaints are automatically added to your suppression list to prevent future sends.
</Note>

***

## Data Retention

Email logs are retained for **30 days**. After 30 days:

* Individual email logs are automatically deleted
* Aggregate metrics remain available
* Suppression list entries remain permanent

***

## Exporting Logs

Export email logs as CSV for analysis:

1. Go to **Email Logs**
2. Apply any filters
3. Click **Export**
4. Download CSV file

Exported data includes all fields visible in the detail view.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Email shows 'sent' but not 'delivered'" icon="clock">
    **Possible causes:**

    * Delivery is still in progress (wait a few minutes)
    * Recipient's server is slow to respond
    * Email was soft-bounced and will retry

    **Action:** Check again in 15-30 minutes. If still not delivered, check bounce status.
  </Accordion>

  <Accordion title="Opens not tracking" icon="eye-slash">
    **Possible causes:**

    * Open tracking is disabled for this domain
    * Recipient's email client blocks images
    * Email client uses a privacy proxy (Apple Mail Privacy Protection)

    **Note:** Open tracking is becoming less reliable due to privacy features in modern email clients.
  </Accordion>

  <Accordion title="Clicks not tracking" icon="link-slash">
    **Possible causes:**

    * Click tracking is disabled for this domain
    * Links weren't rewritten (plain text emails)
    * Security software pre-clicked links

    **Note:** Some security tools click all links to scan for malware, which can inflate click counts.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Domain Metrics" icon="chart-line" href="/sending-domains/metrics">
    View aggregate statistics
  </Card>

  <Card title="Suppression List" icon="ban" href="/sending-domains/suppression-list">
    Manage blocked addresses
  </Card>
</CardGroup>