> ## 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.

# Suppression List

> Manage email addresses that are blocked from receiving emails

## Overview

The suppression list contains email addresses that should not receive emails from your account. Migma automatically blocks sending to these addresses to protect your domain reputation.

Open the list at **Contacts → Suppression**. Each address shows the reason it was added — *bounce*, *complaint*, *unsubscribe*, or *manual* — along with the underlying detail (SMTP bounce subtype, complaint type, or soft-bounce streak count) so you can tell *why* an address landed on the list.

<Tip>
  Open **Contacts → Suppression**. Filter by bounce, complaint, unsubscribe, or manual block.
</Tip>

***

## How It Works

When you try to send to a suppressed email:

1. Email is blocked before sending
2. No delivery attempt is made
3. The send is logged as "suppressed"
4. Your sending quota is not affected

This prevents damage to your sender reputation from repeated bounces or complaints.

***

## Suppression Reasons

| Reason          | Description                          | How Added |
| --------------- | ------------------------------------ | --------- |
| **bounce**      | Email previously bounced (permanent) | Automatic |
| **complaint**   | Recipient marked email as spam       | Automatic |
| **unsubscribe** | Recipient unsubscribed               | Automatic |
| **manual**      | Added by you                         | Manual    |

***

## Automatic Suppression

Migma automatically adds addresses when:

### Permanent Bounces

When an email permanently bounces:

* Invalid email address
* Domain doesn't exist
* Mailbox not found

**Added immediately** after the first permanent bounce.

### Spam Complaints

When a recipient marks your email as spam:

* Through their email client (Gmail, Outlook, etc.)
* Via ISP feedback loop

**Added immediately** upon receiving the complaint.

### Unsubscribes

When a recipient unsubscribes:

* Via unsubscribe link in email
* Through preference center
* Via List-Unsubscribe header

**Added immediately** upon unsubscribe.

***

## Viewing the List

### List View

The suppression list shows:

| Column     | Description                            |
| ---------- | -------------------------------------- |
| **Email**  | The suppressed email address           |
| **Reason** | Why they were suppressed               |
| **Source** | How they were added (automatic/manual) |
| **Domain** | Which domain triggered suppression     |
| **Date**   | When they were suppressed              |

### Filtering

Filter the list by:

* **Reason**: bounce, complaint, unsubscribe, manual
* **Date range**: When added
* **Search**: Email address

***

## Managing Suppressions

### Adding Addresses Manually

Add addresses you know shouldn't receive email:

<Steps>
  <Step title="Go to Suppression List">
    Navigate to **Contacts → Suppression**
  </Step>

  <Step title="Click Add">
    Click **Add to Suppression List**
  </Step>

  <Step title="Enter Email">
    Enter the email address to suppress
  </Step>

  <Step title="Save">
    Click **Add** to confirm
  </Step>
</Steps>

### Bulk Import

Import multiple addresses at once:

1. Click **Import**
2. Upload a CSV file with email addresses
3. Review the preview
4. Confirm import

**CSV Format:**

```csv theme={null}
email
user1@example.com
user2@example.com
user3@example.com
```

### Removing Addresses

<Warning>
  Be careful when removing addresses. If they were added due to a bounce or complaint, sending to them again will likely hurt your reputation.
</Warning>

To remove an address:

1. Find the address in the list
2. Click the remove icon
3. Confirm removal

**When it's safe to remove:**

* Manual additions that are no longer needed
* Addresses that were mistakenly added
* Re-engagement campaigns (with explicit permission)

***

## Suppression and Sending

### What Happens When You Send

When sending to a list that includes suppressed addresses:

| Result         | Count                                        |
| -------------- | -------------------------------------------- |
| **Sent**       | Emails delivered to non-suppressed addresses |
| **Suppressed** | Emails blocked (suppressed addresses)        |

You'll see both counts in your send report.

### Partial Sends

If you send to 1,000 recipients and 50 are suppressed:

* 950 emails are sent
* 50 are suppressed (not sent, not billed)
* Your report shows both numbers

***

## Best Practices

<AccordionGroup>
  <Accordion title="Never remove automatic suppressions" icon="shield">
    Addresses added automatically (bounces, complaints) should stay suppressed:

    * **Bounces** will bounce again, hurting your rate
    * **Complaints** may complain again, worse for reputation
    * **Unsubscribes** requested not to receive email

    Only remove if you have explicit new permission from the person.
  </Accordion>

  <Accordion title="Export before large campaigns" icon="download">
    Before major sends:

    1. Export your suppression list
    2. Cross-reference with your send list
    3. Ensure your list is clean

    This prevents surprises in your send reports.
  </Accordion>

  <Accordion title="Import known bad addresses" icon="upload">
    Proactively suppress:

    * Role addresses (admin@, info@, support@)
    * Known spam traps
    * Previous hard bounces from other systems
    * Competitors' addresses

    This protects your reputation before issues occur.
  </Accordion>
</AccordionGroup>

***

## Exporting the List

Export your suppression list for backup or analysis:

1. Go to **Suppression List**
2. Apply any filters (optional)
3. Click **Export**
4. Download CSV file

**Exported data includes:**

* Email address
* Reason
* Source
* Date added
* Domain (if applicable)

***

## Data Retention

Suppression list entries are **permanent** by default:

* No automatic expiration
* Manual removal required
* Protects against re-adding problematic addresses

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Skipped Recipients" icon="filter-circle-xmark" href="/campaigns/skipped-recipients">
    See per-campaign which contacts were filtered out and why
  </Card>

  <Card title="Deliverability & Validation" icon="shield-check" href="/audience/deliverability">
    Risky-address filtering and contact re-validation
  </Card>

  <Card title="Domain Health" icon="heart-pulse" href="/sending-domains/domain-health">
    Monitor reputation metrics
  </Card>

  <Card title="Send to Audience" icon="paper-plane" href="/audience/sending-emails">
    Send emails safely
  </Card>
</CardGroup>