Mail configuration variables

Variable

Type

Default Value

Description

d2l.Tools.Mail.
AddDefaultCourseAssociations

Org

ON

Adds default course associations to D2L email.

d2l.Tools.Mail.
AddNameToEmail

Org

OFF

Names are added to email addresses.

d2l.Tools.Mail.AutoCompleteMaxEnrollments

Org

1500

The maximum number of enrollments that work with auto complete on current course contacts in the recipient fields on the compose email page. In courses with more enrollments than this, auto complete on contacts in the current course will not work.

d2l.Tools.Mail.
AutomaticSubjectText

Org

N/A

Automatically includes Subject Text.

d2l.Tools.Mail.
AutomaticSubjectTextOrgUnit

OrgUnit

N/A

Automatically includes Subject Text for org units.

d2l.Tools.Mail.Client.
IMAP.CanEditServer

Org

OFF

Allows the user to edit the IMAP server to connect to.

d2l.Tools.Mail.Client.
IMAP.Server

Role

N/A

Determines the mail server for this user.

d2l.Tools.Mail.Client.
MailboxSorting

User

N/A

Determines the sorting criterion for the mailbox.

d2l.Tools.Mail.D2LMailDomain

Org

brightspace.com

Defines the mail domain for D2L mail. Note:As of May, 2020, users with Org Admin permissions cannot edit this configuration variable.

d2l.Tools.Mail.D2LMailDomainOverrides Org

N/A

Users with ExternalEmail matching the domains listed in this are able to use their ExternalEmail as their FromAddress. Note: Users with Org Admin role permissions can now see this configuration variable.

d2l.Tools.Mail.
DisableSendOnlyMailTracking

Org

OFF

Only applies when using send only mail. When this configuration is on, sent mail is not stored in the system.

d2l.Tools.Mail.
DomainExceptionsforSendReceive

Org

N/A

When this variable has a value, each user of the email tool will be able to send messages to any email domains or addresses provided here, provided they have permission to send messages and that a valid SMTP server is setup.

d2l.Tools.Mail.
EmailSelectedRecipientsInBcc

Org

ON

Email Selected Recipients in Bcc.

d2l.Tools.Mail.FilterByDefaultValue

Org

All Messages

Controls what the Filter By drop-down is defaulted to when accessing the Email tool. The selection Current Course Offering defaults the Filter By drop-down to a course offering when the Email tool is accessed from a course offering.

d2l.Tools.Mail.ForwardEmailAction

Org

Mark read

Forward received email, and mark message action.

d2l.Tools.Mail.ForwardToEmailAddress

Org

N/A

Forward received email to the defined external address.

d2l.Tools.Mail.ForwardToExternal

Org

OFF

Forward received emails to an external address.

d2l.Tools.Mail.HasHelpdeskAddress

Org

OFF

Sets whether mail has a helpdesk address.

d2l.Tools.Mail.MaxToCCAddresses Org 50 Sets the maximum number of addresses in the TO or CC fields. If you want to use unlimited addresses, set to 0. Note: Users with Org Admin role permissions can now see this configuration variable.
d2l.Tools.Mail.MaximumNumberOfIndividualAddresses Org 1000 Sets the maximum number of addresses that can be displayed in one field before they are collapsed into a single bulk field. Note: Users with Org Admin role permissions can now see this configuration variable.

d2l.Tools.Mail.NotifierIsEnabled

Org

OFF

Toggles the new mail notifier.

d2l.Tools.Mail.PostmasterAddress

System

helpdesk@example.com

Defines the address for the postmaster of the mail server.

d2l.Tools.Mail.PostmasterName

System

postmaster

Displays the name for the postmaster of the mail server.

d2l.Tools.Mail.ReceiveExternalMail

Org

OFF

Email is configured to receive external mail. Note: As of May, 2020, users with Org Admin permissions cannot edit this configuration variable.

d2l.Tools.Mail.
RestrictContactsByAddressBookOn

Org

OFF

System contacts are restricted to courses with the address book enabled.

d2l.Tools.Mail.
RestrictContactsToAvailableCourses

Org

OFF

Restricts the set of contacts that are shown in the address book when the user filters by All Contacts. These restrictions prevent contacts from inactive courses, courses that have not reached their start date, and courses that have passed their end date from being displayed.

d2l.Tools.Mail.SaveEmail System On Determines if a received email is saved to a backup folder. Note: Users with Org Admin role permissions can now see this configuration variable.

d2l.Tools.Mail.
SendUndeliverableMessagesToSender

Org

ON

A message is generated on undeliverable messages that is sent to the message's original sender from the postmaster address.

d2l.Tools.Mail.ShowPreviewPane

User

ON

Enables a user preference to show the preview pane in the message and contacts lists. Note: Users can override this value in Email > Settings.

d2l.Tools.Mail.Signature

User

N/A

Email signature.

d2l.Tools.Mail.StorageSpace

Role

0

Amount of storage space available (in KB), 0 for unlimited.

d2l.Tools.Mail.UndeliverableMessage

System

The following recipients did not receive
the attached message: {recipients}

Reply sent for undeliverable messages.

d2l.Tools.Mail.
UseReplyToInFromAddress

Org

ON

Populates the From address with the same field as the Reply To address.

This configuration variable is no longer visible to administrators. If you need to change the value of this configuration variable, contact your D2L Account Manager.

d2l.Tools.Mail.UserSettings.
AllowFilterOnGroups

User

ON

Determines if groups are listed below courses in the Filter By list when viewing messages and address book contacts.

d2l.Tools.Mail.UserSettings.
CCExternalEmailOnSend

User

OFF

Copy on all sent messages.

d2l.Tools.Mail.UserSettings.
ForwardEmailAction

User

Mark read (3)

Forward received email, and mark message action.

d2l.Tools.Mail.UserSettings.
ForwardToEmailAddress

User

N/A

Forward received email to this external address.

d2l.Tools.Mail.UserSettings.
ForwardToExternal

User

OFF

Forward received emails to an external address.

d2l.Tools.Mail.UserSettings.
MarkReadWhenPreviewed

User

OFF

Mark email as read when viewed in the preview pane.

d2l.Tools.Mail.UserSettings.
ReplyToAddress

User

N/A

Reply To address.

d2l.Tools.Mail.UserSettings.
ReplyWithHistory

User

OFF

Include original message in email replies.

d2l.Tools.Mail.UserSettings.
SaveCopyOnSend

User

ON

Save a copy of the email message to the Sent folder.

d2l.Tools.Mail.UserSettings.
ShowAuditorsInContacts

User

OFF

Show auditors in the address book.

d2l.Tools.Mail.UserSettings.
ShowExternalEmail

User

ON

Show external email address in address book.

d2l.Tools.Mail.UserSettings.
ShowFolderPane

User

ON

Show the folders pane.

d2l.Tools.Mail.UserSettings.
ShowInternalEmail

User

ON

Show internal email addresses in address book.

d2l.Tools.Mail.Verification.ID Org None Lists either the UserID or UserName of the person initiating an email address change.