Attachment limit properties

Several properties control email attachment limits.

Properties

All the properties are located in the System Property [sys_properties] table. Setting any of the following properties to an excessively large value may cause performance issues.

Table 1. Attachment limit properties
Name Description
glide.email.inbound.max_attachment_count Sets the maximum number of attachments allowed per inbound email.
  • Type: integer
  • Default value: 30
  • Learn more: Inbound Email Attachment Processing
glide.email.inbound.max_total_attachment_size_bytes Sets the maximum total attachment size in bytes allowed per inbound email.
  • Type: integer
  • Default value: 18874368
  • Learn more: Inbound Email Attachment Processing
glide.email.outbound.max_attachment_count Sets the maximum number of attachments allowed per outbound email.
  • Type: integer
  • Default value: 30
  • Learn more: Outbound Email Attachment Processing
glide.email.outbound.max_total_attachment_size_bytes Sets the maximum total attachment size in bytes allowed per outbound email. Note that in order to send an email, the system must encode the contents of the email. This process may significantly increase the size of the email, including any attachments. It is best to set this property to a value well below the maximum email size.
  • Type: integer
  • Default value: 18874368
  • Learn more: Outbound Email Attachment Processing
Note: A different property, com.glide.attachment.max_size, sets the maximum file size allowed for any attachment in the system and overrides any larger values of glide.email.inbound.max_total_attachment_size_bytes and glide.email.outbound.max_total_attachment_size_bytes.

Inbound email attachment processing

For inbound emails, the system enforces the maximum number and size of attachments as set by the glide.email.inbound.max_attachment_count and glide.email.inbound.max_total_attachment_size_bytes properties. When the attachments for an inbound email exceed either value, the system logs a warning and discards the excess attachments. The order in which the system processes the attachments determines which attachments are discarded. This order may not be consistent from email to email.

Inbound email attachment processing

For outbound emails, the system enforces the maximum number and size of attachments as set by the glide.email.outbound.max_attachment_count and glide.email.outbound.max_total_attachment_size_bytes properties. Email records are created from a number of sources and may exceed the configured attachment limits.

Emails that are ready to be sent from the Email [sys_email] table are subject to the outbound attachment limits. Emails that exceed either limit trigger a warning in the email system log and are sent with attachments up to the maximum number or total file size.

The log message for such an email might look like this:
Maximum combined attachment size exceeded. (max:15728640 bytes). One or more attachment records ignored.

Emails for notifications, scheduled reports, and exported tables

Notifications can be set to include all the attachments from the record that triggers the notification. If the attachments exceed either of the outbound email attachment limits, the system excludes the excess attachments from the email and logs a warning message.

Reports can be scheduled for email distribution as attachments. Large reports may exceed the outbound attachment size limit. In this case the system sends the scheduled report email without the report attached and logs a warning message. To avoid the issue, send links to large reports instead of sending the reports as attachments.

If a user attempts to export a number of records from a list that exceeds a configured warning threshold, a dialog box offers the option to email the exported records as an attachment. If the attachment exceeds the outbound attachment size limit, the system sends the email without the exported record list attached and logs a warning message.