Notification Emails

Notifications Email Elements give you the power to manage your email notifications in a central location alongside your content in Craft CMS.

Default Setup

Creating a new Notification Email requires two steps:

1. 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

2. 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

Notification Name
What you want to call the Notification internally.

Entry Template
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:

_emails/notification 

Sprout Email will look for the following two templates in your templates folder. Your email template files must be named email.:

_emails/notification/_emails/email.twig (.html, etc.) _emails/notification/_emails/email.txt 

Email Settings

Notification Emails have several required settings:

Sender

Set the From Name, From Email, and Reply To Email.

Recipients

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

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.

WARNING

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.