Email Settings

Tool Search: Email Settings

The Email Settings tab allows a user to configure general settings for email messages. The initial setup of this tab should be completed before email messaging is attempted.

Google and Yahoo now require enhanced email authentication, specifically through DMARC, SPF, and DKIM starting February 1st, 2024. Please review Email Authentication for DMARC, SPF, and DKIM for more information.

Screenshot of Email Settings

Tool Rights

Users must have at least A(dd) tool rights to configure Email Settings. 

Screenshot of Email Settings Tool Rights

SMTP Server Configuration

The sections below will describe how to configure your email depending on whether or not you will use TLS encryption:

  • Non-TLS Configuration
  • TLS Configuration
  • Field Descriptions (SMTP)

Non-TLS Configuration

To configure the Email Settings for email messaging from an internal school/district server, or other email service that does not use TLS encryption:

Screenshot of Standard Email Settings

The following steps are required for standard setup:

  1. Enter the Default Sender Email Address.
  2. Enter the SMTP Host address. 
  3. Enter the SMTP Port.
  4. Choose the number of Minutes Between Retries (optional).  
  5. Select the allowed Max Errors Before Cancel (optional).
  6. Click the Save icon.

Users are highly advised to enter and Send a Test Email to ensure entered values are correct.

TLS Configuration

To configure the Email Settings to allow emails from email services and SMTP servers that require TLS encryption of transferred messages:

Screenshot of TLS-Encrypted Setup of Email Settings

The following steps are required for standard setup:

  1. Enter the Default Sender Email Address.
  2. Enter the SMTP Host address.
  3. Enter the SMTP Port.
  4. Mark the Use TLS checkbox.

    Users are highly advised to enter and Send a Test Email to ensure entered values are correct.

  5. Click the Save icon. 

Optional Configuration Steps

The following steps are optional for standard setup:

  1. Mark the Use Authentication checkbox and enter values in the authentication fields:
    • Username
    • Password
  2. Choose the number of Minutes Between Retries.
  3. Select the allowed Max Errors Before Cancel.

Field Descriptions (SMTP)

The table below describes each field available:

FieldDescription
Default Sender Email Address

The default email address that appears as the "sent from" address on sent email messages. This field is required.

The Default Sender Email Address must be a real email address so that the recipient’s email server does not view the message as SPAM. A real email address also allows bounce-back messages to be delivered to an actual mailbox even if the mailbox is not monitored.

 

Do not include “infinitecampus” in the email address as this incorrectly gives the impression that emails are being delivered by the company Infinite Campus.


To reduce the chance an email is flagged as spam, avoid using "noreply" or "donotreply" in the Default Sender Email Address.

Use SMTP ServerSelect this radio button to begin configuring email settings for an SMTP server.
SMTP HostThe Simple Mail Transfer Protocol (SMTP) host name used to transfer emails. SMTP is the only protocol supported in Campus.
SMTP PortThe specific port allowing SMTP and email exchange. To use the default SMTP port, leave blank. Otherwise, if a specific port number is required by a service, enter it in this field.
SMTP Timeout

The amount of time that Campus will wait for the SMTP server to respond. If the SMTP server does not respond in the specified amount of time, the message will timeout and Campus will resend the message according the preferences set in the Advanced Settings group on this screen.

The SMTP Timeout dropdown list includes the following options:


    • 30 seconds (default)
    • 1 minute
    • 2 minutes
    • 3 minutes
    • 4 minutes
    • 5 minutes
Use AuthenticationIf a username and password are required for SMTP authentication, this box should be checked. When checked, the Username and Password fields will be unlocked for editing.
Username

The username required for server authentication, if required by SMTP server setup. 

This field is available for editing when the Use Authentication field is set to a value of "Yes."

Password

The password required for server authentication, if required by SMTP server setup. 

This field is available for editing when the Use Authentication field is set to a value of "Yes."

Use TLSCheckbox indicates whether or not Transport Layer Security (TLS) should be used to encrypt email transfer on the server. Some services require this encryption.
Minutes Between RetriesThe number of minutes to wait between a failed message delivery attempt and the next message delivery attempt.
Max Errors Before Cancel

The maximum number of failed message delivery attempts allowed before all attempts to deliver the message are canceled. 

The default value for this field is "10."

Throttle Email MessagesThis option determines the number of email messages the application server will process per second. You may enter any number from 1 to 999.
Allow Email Attachments

This option allows users to add email attachments to messages. When this option is checked, all Messenger tools display the option to send email attachments. When this option is not checked, no tools display the option to send email attachments. 

If there are template email attachments and this checkbox is cleared so that the option to upload an attachment is removed, the templates will NOT send the attachments.
Limit Email Attachment File Size

This option allows you to set size limits for email attachments. If a user tries to attach a file that is larger than the limit set in this field, an error message will display explaining that their file is too large.

The maximum file size is 100 MB and is set in the Campus XML file.

Districts using Campus' SMTP Host are limited to 1.3 MB regardless of what is entered in this field.

 

Large email attachments of several MBs will take several minutes to upload.

If there are templates with email attachments and this field is changed to a limit lower than what exists on the saved templates, the templates WILL send the saved email attachment. If the template is changed and saved, you will not be able to save the large email attachment.

User Sender's Email from Census as Reply to Email Address

Mark this checkbox to have the sender's email address (Census > People > Demographics > Email) auto-populate the Reply To Email field in the Message Builder and Staff Messenger tools. 

Screenshot of the reply to email field auto-populated by personal contact information

If the default language en_US is removed from Attribute Dictionary > Contact > Pref. Language, the option to User Sender's Email from Census will not work. Districts can add/edit other languages within the Attribute Dictionary, but should never edit or delete en_US.


This option does not apply to Emergency Messenger.  Emergency Messenger uses the Email Address from the Default Sender Email Address on this screen.

Allow Custom Reply to Email Address

Mark this checkbox to have the Reply to Email field in the Message Builder and Staff Messenger tools unlocked and able to be edited.

Screenshot of the reply to email field

If you check both the User Sender's Email from Census as Reply to Email Address and Allow Custom Reply to Email Address checkboxes, the Reply to Email field will auto-populate with the sender's email address but remain unlocked and able to be edited.

 

This option does not apply to Emergency Messenger. Emergency Messenger uses the Email Address from the Default Sender Email Address on this screen.

Allow Custom Sender Display NameMark this checkbox to have the Sender Display Name field display in the Message Builder, Staff Messenger and Emergency Messenger tools. If enabled, the field will display only when Email is selected from the Delivery Devices options. This field allows the sender to customize the name they would like displayed in the recipient's email inbox for easier identification purposes.
Screenshot of the sender display name field.
Require Custom Sender Display Name in Campus InstructionMark this checkbox to display the Sender Display Name field in Campus Instruction messenger tools. When marked, an entry is required before the message can be sent.

This checkbox is available only when the Allow Custom Sender Display Name checkbox is marked.
Send Test EmailEnter a valid email address and select the Send Test Email button to test whether the Email Settings entered above this field are correct. If you receive the test email in your inbox, your Email Settings are configured properly. If you do not receive the test email, this indicates one or more of the fields above is incorrect or invalid.

Mailgun Configuration

Mailgun is a third party email relay system Campus uses to distribute emails out to service providers. Campus provides Mailgun to Campus Cloud (CC) or Campus Cloud Choice (CCC) hosted districts. Non-CC/CCC hosted districts can obtain an account directly from Mailgun if desired. This section will walk you through configuring Campus to send email messages using Mailgun.

Screenshot of Mail gun Configuration

The following steps are required for a Mailgun setup:

  1. Enter the Default Sender Email Address.
  2. Select the Use Mailgun API radio button. 
  3. Enter your Mailgun Domain
  4. Enter an email address in the Test Email Setting Configuration section and click the Send Test Email button. This test email allows you to ensure the settings you have entered are correct. 
  5. Click the Save icon.

Optional Configuration Steps

See the table below for more information about remaining optional fields found in the editor. 

Field Descriptions (Mailgun)

The table below describes each available field.

FieldDescription
Default Sender Email Address

The default email address that appears as the "sent from" address on sent email messages. This field is required.

The Default Sender Email Address must be a real email address so that the recipient’s email server does not view the message as SPAM. A real email address also allows bounce-back messages to be delivered to an actual mailbox even if the mailbox is not monitored.

 

Do not include “infinitecampus” in the email address as this incorrectly gives the impression that emails are being delivered by the company Infinite Campus.


To reduce the chance an email is flagged as spam, avoid using "noreply" or "donotreply" in the Default Sender Email Address.

Use Mailgun API

Mark this radio button if you use Mailgun as your email delivery service.

 

This feature is only relevant for users who use Mailgun as their email delivery service. This functionality is only available for Campus Cloud and Cloud Choice customers.

Mailgun DomainThe domain tied to your Mailgun account.
Minutes Between RetriesThe number of minutes to wait between a failed message delivery attempt and the next message delivery attempt.
Max Errors Before Cancel

The maximum number of failed message delivery attempts allowed before all attempts to deliver the message are canceled. 

The default value for this field is "10."

Throttle Email MessagesThis option determines the number of email messages the application server will process per second. You may enter any number from 1 to 999.
Allow Email Attachments

This option allows users to add email attachments to messages. When this option is checked, all Messenger tools display the option to send email attachments. When this option is not checked, no tools display the option to send email attachments. 

 

If there are template email attachments and this checkbox is cleared so that the option to upload an attachment is removed, the templates will NOT send the attachments.

Limit Email Attachment File Size

This option allows you to set size limits for email attachments. If a user tries to attach a file that is larger than the limit set in this field, an error message will display explaining that their file is too large.

The maximum file size is 100 MB and is set in the Campus XML file.

Districts using Campus' SMTP Host are limited to 1.3 MB regardless of what is entered in this field.

 

Large email attachments of several MBs will take several minutes to upload.

If there are templates with email attachments and this field is changed to a limit lower than what exists on the saved templates, the templates WILL send the saved email attachment. If the template is changed and saved, you will not be able to save the large email attachment.

Use Sender's Email from Census as Reply to Email Address

Mark this checkbox to have the sender's email address (Census > People > Demographics > Email) auto-populate the Reply To Email field in the Message Builder and Staff Messenger tools.

Screenshot of the reply to email field auto-populated by personal contact information

If the default language en_US is removed from Attribute Dictionary > Contact > Pref Language, the option to User Sender's Email from Census will not work. Districts can add/edit other languages within the Attribute Dictionary, but should refrain from editing or deleting en_US.


This option does not apply to Emergency Messenger. Emergency Messenger uses the Email Address from the Default Sender Email Address on this screen.

Allow Custom Reply to Email Address

Mark this checkbox to have the Reply to Email field in the Message Builder and Staff Messenger tools unlocked and able to be edited.

Screenshot of the Reply to Email field

If you check both the User Sender's Email from Census as Reply to Email Address and Allow Custom Reply to Email Address checkboxes, the Reply to Email field will auto-populate with the sender's email address but remain unlocked and able to be edited.

 

This option does not apply to Emergency Messenger. Emergency Messenger uses the Email Address from the Default Sender Email Address on this screen.

Allow Custom Sender Display NameMark this checkbox to have the Sender Display Name field display in the Message Builder, Staff Messenger and Emergency Messenger tools.  If enabled, the field will display only when Email is selected from the Delivery Devices options. This field allows the sender to customize the name they would like displayed in the recipient's email inbox for easier identification purposes.
Screenshot of sender display name field
Require Custom Sender Display Name in Campus InstructionMark this checkbox to display the Sender Display Name field in Campus Instruction messenger tools. When marked, an entry is required before the message can be sent.

This checkbox is available only when the Allow Custom Sender Display Name checkbox is marked.
Send Test EmailEnter a valid email address and select the Send Test Email button to test whether the Email Settings entered above this field are correct. If you receive the test email in your inbox, your Email Settings are configured properly. If you do not receive the test email, this indicates one or more of the fields above is incorrect or invalid.

Review Sent Messages via Mailgun API

The Mailgun Message Log allows you to review all messages sent in the last 30 days via the Mailgun API. 

Screenshot of Mail gun Message Log

Google and Yahoo now require enhanced email authentication, specifically through DMARC, SPF, and DKIM starting February 1st, 2024.