Suppressions are a mechanism Mailgun utilizes to help ensure the protection of your domain's reputation, as well as the reputation of our IP's. Specifically, this is all about internally preventing delivery to addresses that have been demonstrated as problematic for various reasons.
Since they've been proven to encounter issues with receiving mail from your domain in a way you certainly don't want repeated, we internally block sending to these addresses so they don't harm your ability to keep sending. Without Suppressions to prevent further sending to these particular addresses, your domain would run into AUP violations such as high bounce and complaint rates, severely damaging your email deliverability; exactly what we don't want!
How are Suppressions Organized?
Suppressions are organized per domain, since they're based on the proven interaction with a specific send. To view Suppressions, you can either use the Mailgun control panel or view programmatically through the relevant APIs (see below, under Types of Suppressions). In addition to just viewing your current Suppressions, you can add/delete single addresses, or even entire groups of addresses.
If you're using the classic UI (options across the top, with a silver background), you can simply:
- Click on the Suppressions tab at the top of the screen. You'll then filter via the silver dropdown on the left, and can either view all Suppressions for that domain by default, or search for a specific address via the blank on the right.
If you're using the beta UI (options displayed down the left-hand side on a dark column), you'll just:
- Click Messages on the left of your screen
- Select your domain name
- Click on Suppressions. You can either view all Suppressions for that domain by default, or search for a specific address via the blank on the right.
Types of Suppressions
There are three types of Suppressions; Bounces, Unsubscribes, and Complaints.
- Bounces - These aren't just any bounces/failures; rather, these are those bounces that specifically happen due to a recipient's address being returned as invalid/non-existent/temporarily misconfigured.
When the viewing the Bounces portion of the Suppressions page in the Mailgun control panel, the page will list the address, the date the bounce occurred, and the error message the recipient's email server returned that prompted our system to add the address. This way, you see exactly why the address was added to the list. You can also pull these results via the API: https://documentation.mailgun.com/en/latest/api-suppressions.html#bounces
- Unsubscribes - Pretty simple; when a recipient no longer wishes to receive emails, and has clicked to unsubscribe.
With Unsubscribes, the Suppressions tab will list the address, the date the unsubscribe was received, and the details such as "*" for a domain-wide unsubscribe or a specific Tag value for a campaign-based unsubscribe. (Note: subscription status of a member in a Mailing List is indicated in the Mailing List section of the Control Panel). Or, you can use the API: https://documentation.mailgun.com/en/latest/api-suppressions.html#unsubscribes
- Complaints - Also simple; when a recipient complains about your sending by clicking to mark it as spam in their inbox.
Finally, for Complaints, the Suppressions site will list the address and the date the complaint was received; the details column is not used for complaints. To use the API, look here: https://documentation.mailgun.com/en/latest/api-suppressions.html#complaints
As addresses are added to your Mailgun Suppressions, we highly recommend regularly removing those addresses from any contact lists you maintain. This will ensure that you are no longer sending to these addresses through your sending application. To be clear, the addresses should be removed from your contact lists - wherever they may be stored (e.g. CRM, database, file, etc) - and not from the Mailgun Suppressions. If you just remove the addresses from Suppressions list in Mailgun, and not from your contact lists, the process starts over, and you're again risking damaging your reputation.
For other best practices such as our list management practices, subscribe handling practices, and feedback loops and spam complaints practices, please see our Email Best Practices documentation. Additionally, you may also want to consider using our excellent email validation service to ensure your lists are not overflowing with invalid email addresses from the start. This way, you're using Suppressions in the most effective way possible. Always best to stay ahead of the game!
If any questions arise, just reach out to our Support team via the Support tab in your Mailgun control panel!