Additional email properties

There are several advanced email properties that you can use to fine tune the way your instance sends or receives email.

You must add these properties to the System Property [sys_properties] table before they can be used to overwrite the defaults.
Table 1. Additional properties
Property Description
com.glide.email.max_body_bytes Sets the maximum body size in bytes allowed per inbound email.
  • Type: integer
  • Default value: 1048576
com.glide.email.max_read Specifies the maximum number of emails a POP3 reader should process concurrently.
  • Type: integer
  • Default value: 20
com.snc.on_call_rotation.reminders.showtz Specifies whether to show a user's timezone.
  • Type: true | false
  • Default value: false
glide.email.inbound.calendar_behavior Specifies how the system stores calendar data, such as an invitation or an invitation response. Enter one of these options (not case sensitive):
  • Attach: Store the calendar data as an attachment on the associated record, such as the incident or change that triggers an invitation.
  • Ignore: Discard the calendar data.
  • Inline: Store the calendar data as text in the email Body field.
  • Type: string
  • Default value: Attach
glide.email.inbound.convert_html_inline_attachment_references Specifies whether to convert inbound email HTML so email images appear in the email HTML body preview. The system displays broken cid (content ID) links in place of images received when this property is disabled. The format in which the system displays an email image depends on the property setting at the time the email is received, not the current property setting.
  • Type: true | false
  • Default value: true
glide.email.inbound.max_attachment_count Sets the maximum number of attachments allowed per inbound email. This property is available starting with the Eureka Patch 4 release.
  • Type: integer
  • Default value: 30
  • Location: System Property [sys_properties] table
glide.email.inbound.max_total_attachment_size_bytes Sets the maximum total attachment size in bytes allowed per inbound email. This property is available starting with the Eureka Patch 4 release..
  • Type: integer
  • Default value: 18874368
  • Location: System Property [sys_properties] table
glide.email.mail_to Specifies the email address for sending notifications that use the ${mailto:} variable.
  • Type: string
  • Default value: value of glide.email.user property
glide.email.name_split Specifies the delimiter used between first and last names in an email address. For example, a delimiter of "." (period) in the email address john.smith@company.com tells the system to look for a user record for John Smith.
  • Type: string
  • Default value: period (.)
glide.email.notification.save_when_no_recipients Controls whether a notification-generated sys_mail record is saved even if there are no recipients. Used in conjunction with other notification recipient logging properties, this property enables troubleshooting problems with notifications.
  • Type: true | false
  • Default value: true
glide.email.outbound.header.auto_submitted Stores the value used in the "Auto-submitted" outbound email header. Clear the property value to remove the "Auto-submitted" header from all outbound emails. Some spam filters flag auto-generated email as spam.
  • Type: string
  • Default value: auto-generated
glide.email.outbound.max_attachment_count Sets the maximum number of attachments allowed per outbound email. This property is available starting with the Eureka Patch 4 release.
  • Type: integer
  • Default value: 30
  • Location: System Property [sys_properties] table
glide.email.outbound.max_body_bytes Sets the maximum body size in bytes allowed per outbound email.
  • Type: integer
  • Default value: 1048576
glide.email.outbound.max_total_attachment_size_bytes Sets the maximum total attachment size in bytes allowed per outbound email. This property is available starting with the Eureka Patch 4 release.
  • Type: integer
  • Default value: 18874368
  • Location: System Property [sys_properties] table
glide.email.override.url Sets the URL to use in emailed links in place of the instance URL. The URL should end with nav_to.do. An example value is: https://servicenow.customerdomain.com/production/nav_to.do. This property is suitable for customers who use custom redirect URLs for their instances.
  • Type: string
  • Default value:instance URL
glide.cms.use_email_override_url Forces the system to use the glide.email.override.url property, rather than the glide.servlet.uri property, when a notification has a link to a CMS page in an instance.
  • Type: true | false
  • Default value: false
  • Location: System Property [sys_properties] table
glide.email.smtp.max_recipients Specifies the maximum number of recipients the instance can list in the To: line for a single email notification. Notifications that would exceed this limit instead create duplicate email notifications addressed to a subset of the recipient list. Each email notification has the same maximum number of recipients.
  • Type: integer
  • Default value: 100
glide.email.smtp.max_send Specifies how many emails to send through each new SMTP connection. The instance establishes a new SMTP connection if there are more emails to send than the specified value.
  • Type: integer
  • Default value: 100
glide.email.text_plain.strip_xhtml Indicates whether both outbound and inbound emails that are shown in comments convert the XML to plain text (true) or preserve the XML (false).
  • Type: true | false
  • Default value: true
glide.imap.secure Specifies whether to enable SSL encryption for connections to the IMAP server.
  • Type: true | false
  • Default value: false
glide.imap.secure.port Specifies the communications port for IMAP secure connections.
  • Type: string
  • Default value: 995
glide.imap.tls Specifies whether to start the IMAP server in Transport Layer Security (TLS) mode.
  • Type: true | false
  • Default value: false
glide.notification.recipient.exclude_logging Master switch to enable or disable logging all reasons a recipient was excluded. If set to true, the subsequent properties dealing with the exclusion of logging are enabled. If it is set to false, none of the subsequent properties relating to the exclusion of logging are enabled. This property cannot suppress log messages generated by the glide.email.test.user property.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_logging.device_inactive Logs recipients who are excluded because their chosen notification device record is marked as inactive.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_logging.device_schedule Logs recipients who are excluded based on the Schedule field on the New Device for System Administrator form for their chosen notification device.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_logging.event_creator Logs recipients who are excluded because they initiated the notification event, such as updating an incident record, and the Send to Event Creator check box is cleared on the notification record.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_logging.invalid_email Logs recipients who are excluded because the email address for that user is invalid, for example the @ is missing, or empty.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_ logging.user_calendar_integration_disabled Logs recipients of calendar invitations who are excluded because the Calendar Integration field is set to None on the user record.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_logging.user_inactive Logs recipients who are excluded because the the Active check box is cleared on the user record.
  • Type: true | false
  • Default value: true
glide.notification.recipient.exclude_ logging.user_notification_disabled Logs recipients who are excluded because the Notification field is set to Disabled on the user record.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging Master switch to enable or disable logging all reasons a recipient was included. If set to true, the subsequent properties dealing with the inclusion of logging are enabled. If it is set to false, none of the subsequent properties relating to the inclusion of logging are enabled.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging.delegate Logs recipients who are included because they are delegates of another user.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging.event_parm Logs recipients who are included because they are in the parm1 or parm2 fields of the event record.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging.recipient_fields Logs recipients who are included via a notification target record, such as an incident record, specified in the Users/Groups in Field field for the notification record. The recipient_fields are fields in the target record that contain a recipient to add. For example, if the record that triggered the notification is an incident, and the assigned_to field for the incident is listed in recipient_fields, that user is included as a recipient.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_ logging.recipient_groups.group_email Logs recipients who are included in a group email for any group provided in the notification record’s recipient_groups or the event parm1 or parm2 field.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_ logging.recipient_groups.manager Logs recipients who are included because they manage any group provided in the notification record’s recipient_groups or the event parm1 or parm2 field.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_ logging.recipient_groups.membership Logs recipients who are included via membership in any group provided in the notification record recipient_groups or the event parm1 or parm2 field.
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging.recipient_users Logs recipients who are included via notification record’s Users field (recipient_users).
  • Type: true | false
  • Default value: true
glide.notification.recipient.include_logging.subscription Logs recipients because they are subscribed via User Notification Preferences.
  • Type: true | false
  • Default value: true
glide.pop3.parse_start Specifies the text that indicates the beginning of the email body section. The instance parses name:value pairs within this section to set or update field values when processing inbound email actions.
  • Type: string
  • Default value: none
glide.pop3.parse_end Text indicating the end of the email body section where the instance should parse name:value pairs to update field values when processing inbound email actions.
  • Type: string
  • Default value: none
glide.smtp.dateformat Specify the date format to use for outgoing email notifications.
  • Type: string
  • Default value: date format listed in email sender's user record [sys_user.date_format]
glide.smtp.precedence_bulk Specifies whether outbound email includes the header "Precedence: bulk". Some spam filters flag bulk email as spam. Set the value to false to remove this header from outbound email.
  • Type: true | false
  • Default value: true
glide.smtp.secure Use the glide.smtp.encryption property in the Outgoing Mail Server section of the Mail Properties page to specify how to encrypt communications with the SMTP server.
  • Type: true | false
  • Default value: false
glide.smtp.timeformat Specify the time format to use for outgoing email notifications.
  • Type: string
  • Default value: time format listed in email sender's user record [sys_user.time_format]
glide.smtp.tls Use the glide.smtp.encryption property in the Outgoing Mail Server section of the Mail Properties page to specify how to encrypt communications with the SMTP server.
  • Type: true | false
  • Default value: false
glide.ui.activity.email.use_display Specifies whether to display email addresses or user IDs (display value from the User table) in email headers. If true, the instance searches for a user record with a matching email address. If it cannot find a matching user record, it displays the email address.
  • Type: true | false
  • Default value: false
glide.ui.email_client.email_address.disambiguator Sets the columns from the User [sys_user] table that the autocomplete list displays. Separate each column name with a semicolon character (;).
  • Type: string
  • Default value: name
  • Learn more:Displaying Additional Information in the Email Client Autocomplete
glide.ui.incident_activity.max_addresses Specifies the maximum number of addresses to list in an email audit record. If the number of addresses exceeds this limit, the instance truncates the list after the maximum value and displays an ellipsis character (...).
  • Type: string
  • Default value: 5
NotifyAffectedCI.max_rel_level Sets a value used by the Affected ci notifications business rule, which notifies subscribers when configuration items (CIs) are affected by tasks. The business rule generates notifications for parent CIs up to the level defined by this property. You might need to adjust the property value according to the complexity and depth of your CI relationships.
  • Type: integer
  • Default value: 5