Enabling attachments in tickets

Agents and end users can send each other attachments through tickets. Zendesk Support accepts attachments from users sent in via the API, email, web form, and Web Widget channels in your Help Center.

Administrators can configure how attachments are handled in a number of ways, including setting privacy rules, end user permissions, and attachment methods.

This article includes the following topics:

• About email attachments
• Enabling email attachments for agents
• Allowing end users to attach files to tickets
• Enabling private attachments
• Attachment size limitations

About email attachments

Agents and end users can add attachments when creating or updating a ticket, or replying to an email notification. The attachments become linked attachments, which are links to external files that can be used to download the attachments, if and when they’re needed. This is the default behavior for attachments sent by email and this is what happens when email attachments are not enabled.

If email attachments are enabled, the behavior is different. Agents and end users can send email attachments instead of linked attachments. Email notifications caused by creating or updating a ticket, or replying to an email, include actual attachments, instead of links to attachments. Email attachments appear as images and are a preview of the first page of the file.

All files attached via email are scanned for harmful viruses before being sent in an email notification. If an attachment is found to include a virus, it is not included in the email notification. Instead, the recipient is sent an error message stating an attached file was not sent, and recommends they contact the original sender.

The sender does not receive a notification when an attachment is not sent.

There are two types of email attachments:

• Inline attachment: You can drag and drop files into the body of an email or comment. The image of the file appears wherever you dropped the file.
• Appended attachment: Attachments that appear at the bottom of a comment and that send as part of the comment's email notification.

When email attachment file size limitations are exceeded, links to attachments appears in email notifications instead (see Attachment size limitations).

Here are examples of what attachments look like to agents and end users.

Situation	Example
Linked email attachment in an email notification in Gmail account
Email attachment in an email notification in Gmail account
Attachment in the ticket interface in Support

Enabling email attachments for agents

The default attachment configuration allows your agents to add files to ticket comments and email notifications as links. You can allow agents to attach files directly to the comment. This type of attachment is stored in Zendesk Support and is accessible from the ticket interface. You can attach any file type you want.

You can also allow end users to add attachments to tickets (see Allowing end users to attach files to tickets).

To enable email attachments

1. Click the Admin icon () in the sidebar, then select Settings > Tickets.
2. Under the Settings tab, select Include attachments in emails.
   Note: This setting does not appear and cannot be enabled if secure downloads is enabled.
3. At the bottom of the page, click Save tab.

Once enabled, when an agent attaches a file to a comment, it is included as an attachment rather than a link. Only files attached to the current ticket comment are included in the email notification. Files attached to earlier ticket comments are not attached to later email notifications.

For information about how to send an attachment as an agent, see Adding attachments to ticket comments.

Allowing end users to attach files to tickets

You can allow end users to send attachments when filing a ticket or responding to an email notification. The permissions granted to agents, described in Enabling email attachments for agents, apply to end users when this setting is configured.

To enable attachments from end users

1. Click the Admin icon () in the sidebar, then select Settings > Tickets.
2. Next to Attachments, select the Customer can attach files check box.
3. Click Save tab.

Enabling private attachments

Regular attachments to tickets are secured using a URL with an attachment token that is considerably complex and random, but are visible to anyone with the URL and token. When relying on this type of security, if an email notification is misdirected to someone other than the intended end user, sensitive information may be accidentally exposed.

If sensitive documents are attached to your tickets, especially identification documents such as passports and driver's licenses, you can enable private attachments. When enabled, agents and end users will be required to sign in to view attachments.

Note the following about enabling private attachments:

• Private attachments can only be used if Guide is activated. If Guide isn't activated, private attachments prevent end users from downloading attachments since they can't be authenticated.
• If you enable private attachments, it will also disable inline images for users who aren't signed in.
• When an attachment is associated with a ticket, visibility is restricted to users with access to the ticket.
• In the Zendesk Agent Workspace, this setting also applies to attachments sent as part of a live chat, but it does not apply to social messaging or Zendesk messaging attachments (see Securing chat attachments in the Zendesk Agent Workspace).

To enable private attachments

1. Click the Admin icon () in the sidebar, then select Settings > Tickets.
2. Next to Attachments, select the Enable secure downloads check box.
   Note: Include attachments in emails doesn't appear and cannot be enabled if secure downloads is enabled. Additionally, when you enable secure downloads, agents won't be able to copy and paste images from their computer into ticket comments.
3. Click Save tab.

Attachments are not indexed by search engines unless the link for the attachment itself has been published in a Help Center article or something similar. This is the case whether private attachments is on or off. Additionally, when this setting is enabled users will not be able to copy and paste images directly in to tickets.

Attachment size limitations

Email attachment limits are as follows:

• Email attachment (meaning an inline and appended attachment) limit for a single file is 7 MB.

  The total of all email attachments cannot exceed 10 MB. When these limits are exceeded, Support will attempt to process the attachment as a linked attachment instead.

• Linked attachment for a single file is 50 MB.

  If you try to attach a file that is larger than 50 MB, an error message will display and inform you that the file is too large. The attachment will be dropped, meaning it will not be attached to the ticket (as either an email or linked attachment).

For more information about attachment types, see About email attachments.

Attachments from earlier comments are included in email notifications as linked attachments. If you add multiple attachments to a reply, the attachments are prioritized based on the attachment type and size. Inline attachments take precedence over appended attachments when calculating size limits. Note that when inline attachments are sent as links, they still appear as images in the body of the email notification.

The scenarios below describe how this works.

Scenario 1

Two files are attached in the following order:

• Email attachment A (3 MB)
• Email attachment B (6 MB)

Behavior:

• Files A and B are included as email attachments.

Scenario 2

Three files are attached in the following order:

• Inline attachment A (5 MB)
• Email attachment B (5 MB)
• Email attachment C (4 MB)

Behavior:

• Inline attachment A is sent as an email attachment.
• Attachments B and C are included as file links, as they push the total email attachment file size over 10 MB.

Scenario 3

Three files are attached in the following order:

• Inline attachment A (5 MB)
• Inline attachment B (6 MB)
• Inline attachment C (4 MB)

Behavior:

• Attachment A is included as an email attachment.
• Attachment B is included as a file link, as it pushes the total email attachment file size over 10 MB.
• Attachment C is included as a real attachment, as it brings the total email attachment file size to 9 MB.