This document is for an older version of



View latest version →

User Guides

Email Testing with Mailtrap

When building and setting up your site locally, you might wish to test and debug email notifications from Freeform without bothering your client and/or setting up an email server on your development environment. In cases like this, we highly recommend trying out an email testing service such as Mailtrap.

Mailtrap simulates a real SMTP server and allows you to see that each email notification was sent, as well as view all of the recipients' email messages in a single unified inbox, complete with tools to analyze and troubleshoot. This speeds up the testing process and lets you verify how each notification is rendered, etc. For more information, click here to see how it works.

Follow the instructions below to set up Mailtrap for Craft (which then hijacks/controls all email notifications from Craft and Freeform, etc):


  • Sign up for a Mailtrap account.
  • Select the Free account to start (or a paid account if you think you need it).
    • Please note that the Free account does have some limitations:
      • Maximum 500 emails per month
      • Maximum 5 emails every 10 seconds


        This is important to note, as some Freeform forms may be generating more than 5 email notifications. If so, Mailtrap will only collect/display 5 of the X number of notifications from Freeform.

Once your account has been created, click into your new inbox (probably named Demo inbox). The inbox page will default to having an SMTP Settings tab open with credentials.

Mailtrap SMTP Credentials

  • Open a new browser tab and go to the Email settings area in your Craft control panel (CP -> Settings -> Email), and then set up Mailtrap for Craft:
    • Transport Type - select SMTP
    • hostname - use
    • Port - use 2525
    • Check off the Use authentication checkbox
    • Username - copy and paste the username in Mailtrap, e.g. 657gfg765df7f5
    • Password - copy and paste the username in Mailtrap, e.g. 87a569f8768765
    • Encryption Method - select TLS
    • Timeout - 10 Craft Email Settings
  • Click the Test button to verify it's working correctly. If it worked, you'll see an email message inside your Mailtrap inbox. Mailtrap Success


Now any email notification generated by Craft, Freeform or other third party plugins will use Mailtrap.