Email handlers

When a form is submitted, a custom message and/or the submission data can be sent to an email address. This is useful for sending a notification to the site owner or a confirmation email to the user. A list of emails included in a form's submission can be found via Settings > Email / Handlers.

List of emails

Add an email

To add a new email, simply click the "+ Add email" button in the upper right corner. Fill out the following fields:

Title

A title is used solely for display in the list of emails/handlers (see photo above).

To email

Either select "Custom To email address" or select from a list of field values, i.e. Elements (this is meant to be an email address field). This is will determine which email address will receive the message.

From email

You'll likely want to select "Custom From email address" and enter an email address. [site:mail] will send the email from the site's email address (i.e. nhm.org).

Body

A WYSIWYG editor is available for the email body. To add content from the form submission, click Browse available tokens info link to get a list of variables (such as field values from a submission) to include in the email body.

An example of a token is [webform_submission:values:completed] which will insert the date of submission.

Save

Click the "Save" button at the bottom.