Email Notifications
Send an email to your team, confirm a submission with the person who filled out the form, or route a notification based on their answers. Configure notifications in the form builder's Notifications tab.
Send Your First Notification
Open a form and select Notifications.
Click New beside Admin to notify your team, or Email Fields to notify the submitter.
Create a notification template or select an existing one. Set the subject, sender, and email body.
For Admin, add your team's addresses under Recipients. For Email Fields, select the form's Email field under Target field.
Save the form and submit it on your site to test the complete workflow.
Use your site's sending address for From Email. To reply to the submitter, put their email field token or {{ email }} in Reply-To Email, replacing email with your field's handle. See the Reply-to setup guide.
Choose a Notification Type
Each notification can use its own template. Add more than one notification when a form needs to notify several audiences.
| Type | Use it for | Available in |
|---|---|---|
| Admin | Sending to configured team addresses | All editions |
| Conditional | Sending only when field values match your rules | Pro |
| User Select | Routing to a department or team based on selected options | Lite and Pro |
| Email Fields | Sending to an address entered in an Email field | All editions |
You can also configure a template-based notification in the Twig template that displays the form.
Admin
Notify one or more administrators or team members after a successful submission.
Click New beside Admin in the Notifications tab.
Create or select a Notification Template.
Add addresses under Recipients. Press Enter to add another recipient.
ConditionalPro
Send to configured recipients only when the submission matches a set of conditions. For example, notify sales when a visitor requests a quote.
Click New beside Conditional.
Create or select a Notification Template and add Recipients.
Configure the conditions in Rules.
Add another Conditional notification if you need a separate set of rules, recipients, or a different template.
Press Enter to add another recipient address.
See Conditional Rules for rule behavior.
User SelectLitePro
Route notifications using the value selected in a Dropdown, Checkbox, Checkboxes, Radios, or Multiple Select field. A department selector, for example, can send to sales or support.
Add the option field to the form using ordinary option values, such as sales and support.
Click New beside User Select and choose the Target field.
Create or select the Default Notification Template.
In Recipient Mapping, add recipients for each option. You can also assign a different template to an option.
Set Default Recipients if you want a fallback when a selected value has no recipient mapping or its mapping has no recipients. Leave this empty if you do not need a fallback.
For fields that allow several selections, each selected value is processed separately. Press Enter to add more recipients to an option.
Configure recipients in the Notifications tab instead of putting email addresses in the field's options. This keeps the recipient addresses out of the rendered form.
Email Fields
Send a confirmation or other notification to an address entered in an Email field.
Add an Email field to the form. A Text field containing an address cannot be used as the target.
Click New beside Email Fields.
Select the Target field and create or select a Notification Template.
Freeform uses the address entered in the selected field as the recipient.
Tell-a-Friend Forms
To let a submitter notify another person, add a separate Email field and configure an Email Fields notification for it. This uses the same setup as a submitter confirmation.
Allowing visitors to choose recipients can be abused. Configure spam protection before using this approach on a public form.
Template-based
Use dynamicNotification when the Twig template displaying the form should supply its recipients and a global notification template. See the template-based setup for a complete example.
Twig in Recipient Settings
Configured Admin and Conditional recipients, and configured User Select recipient mappings, can use Twig with form, allFields, and field handles. For example, {{ email.valueAsString }} uses the value of the email field. This context is isolated from Craft's global variables.
Addresses submitted through Email Fields or supplied to dynamicNotification are treated as literal addresses. Resolve dynamic values in your form's Twig template before passing them to dynamicNotification; do not pass Twig expressions as recipient strings.
Templates & Customization
Testing & Troubleshooting
A template preview or test email helps check the message's appearance. Submit the actual form as well to verify recipient routing, conditional rules, and attachments.
If notifications do not arrive:
Check Craft's email settings and test the configured mail transport.
Check the notification's target field or recipients and whether its conditions match the submission.
If email queue processing is enabled, confirm that Craft's queue is running.
For local development, follow the Mailtrap setup guide. For broader troubleshooting, see Common Issues.
Configure Email Alerts to receive an alert when a notification cannot be delivered.
Extra Notifications
Resending Email NotificationsPro
To retry notifications after fixing a delivery or template problem, select the affected submissions in Freeform → Submissions and choose Resend Notifications from the actions menu.
Send Additional NotificationPro
To send a separate message, select the submissions and choose Send Additional Notification. Choose a template and enter the recipients. This message is independent of the notifications configured on the form.