Setting up Email Handlers
Email handlers allow your webform to send email notifications when a submission is received. This ensures that the appropriate people are notified about new form submissions without needing to manually check the admin interface.
Accessing Email Handler Settings
Navigate to Structure > Webforms in the admin navigation sidebar, or go to
/admin/structure/webform.Find the webform you want to configure.
Click Settings in the operations dropdown for the webform.
Click the Emails/Handlers tab.
Alternatively, navigate directly to the webform's handlers page at /admin/structure/webform/manage/[webform-id]/handlers.
Adding an Email Handler
On the Emails/Handlers tab, click Add handler.
Select Email from the list of available handlers.
Configure the email handler settings.
Email Configuration
Send To
To email: The email address(es) that will receive the notification. You can:
Enter a specific email address.
Use a token to pull the email from a form field (e.g.,
[webform_submission:values:email]).Enter multiple addresses separated by commas.
CC email: Additional recipients who will receive a copy.
BCC email: Recipients who will receive a blind copy.
From
From email: The sender email address. This should typically be a valid email address from your domain (e.g.,
[email protected]).From name: The sender name displayed in the email (e.g., "Website Contact Form").
Message
Subject: The email subject line. You can use tokens to include dynamic data (e.g.,
New contact form submission: [webform_submission:values:subject]).Body: The email body content. You can:
Use the default body, which includes all submitted values.
Customize the body with specific field values using tokens.
Use HTML or plain text format.
Advanced Settings
Reply to: Set a reply-to address (e.g., the submitter's email) so that replies go directly to the person who submitted the form.
Return path: The address where bounced emails are sent.
Attachments: Include file uploads from the form as email attachments.
Excluded elements: Exclude specific form fields from the email body.
Click Save to add the email handler.
Common Email Handler Configurations
Notification to Site Admin
Send a notification to the site administrator when a new submission is received:
Subject:
New [webform:title] submissionBody: Default (includes all submitted values).
Reply to:
[webform_submission:values:email](if the form has an email field).
Confirmation to Submitter
Send a confirmation email to the person who submitted the form:
To:
[webform_submission:values:email](the submitter's email from the form).Subject:
Thank you for contacting usBody: A customized message confirming receipt of their submission.
Testing Email Handlers
After configuring email handlers:
Submit a test entry through the form.
Verify that all configured email notifications are received.
Check that the email content, subject, and recipients are correct.
Test the reply-to functionality by replying to a notification email.
Delete the test submission from the Results tab.
Troubleshooting
Emails not being sent: Verify that your site's mail system is configured correctly. Drupal requires a functioning mail server or a mail service module (e.g., SMTP, SendGrid) to send emails.
Emails going to spam: Ensure the "From email" address uses your domain and that your domain has proper SPF, DKIM, and DMARC records.
Missing field values: Check that the correct tokens are used in the email body and subject.
Multiple handlers: You can add multiple email handlers to a single webform (e.g., one for the admin notification and one for the submitter confirmation).
Tips
Always set up at least one email handler so that submissions are not missed.
Use a recognizable "From name" so recipients know the email is from your website.
Keep confirmation emails to submitters brief and professional.
Test all email handlers after any changes to the form fields, as new fields may need to be included in the email body.
Last updated