Skip to content
Documentation

Creating a report for bounced contacts in Mautic

When emails bounce in Mautic, these reports help you spot what's going wrong. By splitting bounces into different categories, you can quickly see if there's a pattern - like if a lot of emails are bouncing because of spam filters or if it's just temporary server issues, then take actions.

Requirements

  • Access to Mautic admin interface

Step-by-step guide

  1. Navigate to the Reports page from the left sidebar
  2. Click on New
  3. Create the general bounces report:
    • Name it "All bounces"
    • Add description: Shows you every email that didn't reach its destination, all in one place.
    • Select Do Not Contact as data source
    • Add columns: Email, DNC Reason, DNC Date, DNC Comment
    • Save
  4. Create the soft bounces report:
    • Clone the All bounces report
    • Name it "Bounces (soft)"
    • Add description: Shows emails that failed due to temporary issues like server timeouts or full mailboxes (recoverable).
    • Add these filters with OR conditions:
      • DNC Comment like 4%
      • DNC Comment like %4._._%
      • DNC Comment contains timeout
      • DNC Comment contains connection refused
      • DNC Comment contains Connection reset by peer
      • DNC Comment contains Unable to parse reason from bounce report
  5. Create the spam report:
    • Clone the All bounces report
    • Name it "Bounces (spam)"
    • Add description: Shows which emails got blocked because they looked like spam to the receiver (both contact or automated filter). Often not recoverable.
    • Add a filter:
      • DNC Comment contains spam
      • DNC Comment contains rejected
  6. Create the hard bounces report:
    • Clone the All bounces report
    • Name it "Bounces (hard)"
    • Add description: Lists all the email addresses that don't work anymore and need to be removed (not recoverable).
    • Add multiple filters with OR conditions:
      • DNC Comment contains unrecognized address
      • DNC Comment like 5%
      • DNC Comment like %5._._%
      • DNC Comment contains maildir delivery failed
      • DNC Comment contains invalid
      • DNC Comment contains Bounced Address
      • DNC Comment contains Spam reporting address
      • DNC Comment contains does not exist
      • DNC Comment contains unknown
      • DNC Comment contains Incorrectly formatted email address
      • DNC Comment contains BOGON
      • DNC Comment contains User unsubscribed

Note

This report is great to export from time to time, tag these contacts then remove them using a campaign to clean the database.

How do I know if I executed this process correctly?

  • Each report displays all contacts marked as Do Not Contact (or not, if it’s a new Mautic)
  • You can see bounce information in the DNC Comment column
  • The report shows when contacts were added to DNC in the DNC Date column
  • You can filter and sort the data based on any of the configured columns
← Previous Exporting reports Next → Creating reports to see new contacts added to segment