Notifications Email Elements give you the power to manage your email notifications in a central location alongside your content in Craft CMS.
# Default Setup
# Craft 3
Notification Emails are created with a simple Body field and can immediately used to send triggered emails using the Default Email Template.
To add a custom Field Layout, select 'Edit Field Layout' from the Save button dropdown.
Adding custom fields to your Email will require that you also create Email Templates that work with those fields.
# Craft 2
Creating a new Notification Email requires two steps:
Define the Notification Email: You can create a new notification email and define it's Entry Template and Custom Field Layout in
Sprout Email->Settings (Gear Icon)->Notifications->New Notification
Create the Notification Email: Once you have a notification email defined, you can add your content, set your sender and recipients, and set your rule that triggers the email in the Notification Entry.
Define the Notification Email
What you want to call the Notification internally.
For each email, you will want to create an HTML and a Text template. Both your html and text templates will be determined from the template name you add here. Do not include a filetype in your name, just the name of the file.
For example, if your Notification Entry Template name is:
Sprout Email will look for the following two templates in your templates folder. Your email template files must be named
_emails/notification/_emails/email.twig (.html, etc.) _emails/notification/_emails/email.txt
# Email Settings
Notification Emails have several required settings:
Set the From Name, From Email, and Reply To Email.
Add a comma-separated lists of recipients who you'd like to receive the email. See the Dynamic Notifications doc page for more information on sending notifications to dynamic recipients like the person who submitted an Entry or completed a Form.
Additionally, you can create a Mailing List and send to a list of people. Mailing Lists are a feature provided by Sprout Reports.
Events allow you to choose what Notification Event will trigger a Notification Email and customize the Notification Event settings.
Each time your selected Event happens and your Notification Event settings pass validation, a Notification Email will be sent out to the defined Recipients.
# File Attachments
File Attachments can be enabled in the Notification Email's Event settings. When File Attachments are enabled, Sprout Email will attach any files that are submitted to the Notification using the Craft Assets field or Sprout Forms File Upload field.
Large file attachments may cause Email Notifications to end up in spam filters or not be sent at all. Alternatively, consider sending Notification Emails with a link to the assets you wish to share.