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, Web Widget, and Web Widget (Classic) 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
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.
- 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.
ticket.verbatim_description
), any
attachments originally sent by the end user will not be included in
the automated email notification.- Isn't included in the email notification. Instead, the recipient is notified that an attachment wasn't sent.
- Won't be visible within the ticket to end users.
- Will be visible within the ticket to agents but labeled with a malware warning and unavailable for download.
- Will be visible within the ticket to admins but labeled with a malware warning. Admins can download potentially malicious attachments and choose to override the restricted access for agents.
The sender does not receive a notification when an attachment is not sent.
When email attachment file size limitations are exceeded, links to attachments appear 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 |
|
Malicious attachment in the ticket interface in Support (visible only to team members) | ![]() |
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).
- In Admin Center, click
Objects and rules in the sidebar, then select Tickets > Settings.
- In the Attachments section, select Include
attachments in emails.Note: This setting does not appear and cannot be enabled if secure downloads is enabled.
- 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. Additionally, inline attachments are available only for signed-in end users.
- In Admin Center, click
Objects and rules in the sidebar, then select Tickets > Settings.
- In the Attachments section, select Customers can attach files.
- Click Save tab.
Enabling private attachments
Attachments usually aren't indexed by search engines or included in threat intelligence platforms (TIPs) unless their URLs are publicly shared, like in a help center article or within email notifications to users. 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 must be signed in to view attachments.
End users can see private attachments in their tickets in help center because they have to sign in to view their tickets. However, the attachments will appear as links in email tickets. They'll need to click the links and sign in to the help center to view the 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 disable inline images for users who aren't signed in, and it will also prevent agents and admins from being able to add inline images in Support. Inline images are disabled only for Zendesk hosted images and not images that are publicly accessible.
- 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 web, mobile, or social messaging attachments (see Securing chat attachments in the Zendesk Agent Workspace).
- In web and mobile messaging, private attachments are not currently allowed.
To enable private attachments
- In Admin Center, click
Objects and rules in the sidebar, then select Tickets > Settings.
- In the Attachments section, select Enable secure
downloads.Note: Include attachments in emails doesn't appear and can't be enabled if secure downloads is enabled. Additionally, when you enable secure downloads, agents can't copy and paste images from their computer into ticket comments.
- Click Save tab.
Attachment size limitations
- The inbound email and web form attachment limit for a single file is 50 MB.
- The total of all outbound email attachments cannot exceed 10 MB. When these limits are exceeded, Support will process the attachment as a linked attachment instead.
- The outbound email attachment limit for a single
linked file is 50 MB. Up to 500 files can
be attached.
If you try to attach a file larger than 50 MB, an error message will display and inform you that the file is too large. The attachment will not be attached to the ticket (as either an email or linked attachment).
- When you upload GIF files with a large number of frames, the upload might fail with a timeout error. If this occurs, try recreating the GIF file with fewer frames.
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
- Email attachment A (3 MB)
- Email attachment B (6 MB)
- Files A and B are included as email attachments.
Scenario 2
- Inline attachment A (5 MB)
- Email attachment B (5 MB)
- Email attachment C (4 MB)
- 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
- Inline attachment A (5 MB)
- Inline attachment B (6 MB)
- Inline attachment C (4 MB)
- 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.
To change this setting, go to Admin >Manage > People > Roles and click Edit to the right of the agent's role.
40 comments
Joyce
Creating voicemail tickets that are similar to call tickets created from a Zendesk Talk number can only be achieved when using Talk Partner Edition API. If the voicemail is being sent to Zendesk via an email attachment, that will remain as an attachment in the ticket created.
Hope this clarifies!
0
Alexander Kinsley
Is it possible to configure ZenDesk to automatically apend/prepend the ticket number in the filename of all attachments uploaded by customers/clients?
0
Bruce Williams
This Zendesk documentation appears incorrect or outdated;
Attachment size limitations
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, except for in side conversations.
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).
I have tested Emails received in Zendesk support, creating tickets. If the email contains an attachment greater than 50mb, then the attachment will not be in the ticket, just as bullet 2 says above.
However, with respect to bullet 1, I am seeing that the total of ALL emails in a single attachment, is NOT limited to 10mb. I need to know what the Total limit actually is please.
I tested several scenarios.
#1 - A single email with attachments of 48mb and 6mb. Email was received with both attachments.
#2 - A single email with attachments of 15mb, 6mb and 2mb. Email was received with all 3 attachments.
Please explain what the Total attachment size limit is for a single email.
Thanks
0
Mike DR
That isn't available yet but we do welcome you submitting product feedback here: Giving Product Feedback at Zendesk
0
Bryan Haeussler
I am hoping someone can clarify the inbound limit on attachments on emails? I receive Remote server returned '550 5.7.0 Local Policy Violation - MaxSize Violation for an email with an attachment of 38MB, but I do not for one of 23MB.
I believe this article refers to the outbound limits?
0
Gab
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).
That being said, I've created a ticket on your behalf where I'd be glad to assist you further and continue the conversation there.
0
Sam Turner
Whilst I understand why this is in place it does conflict with workflows, for example;
- We have agents wanting to receive and send attachments (sometimes containing sensitive data)
- These attachment recipients should not be logged in nor have an account and should be able to receive the attachments as attachments in an email.
- The attachments should only be accessible via logged in Agents (enable secure downloads) and recipients of the emails from the tickets in which they raise (enable email attachments).
It would be good to understand if we can be a bit more granular with what ‘Enable Secure Downloads’ affects, having it blanket for both agent and customer side can be counter intuitive and break the experience for the customer.
0
Paolo
Thank you for sharing your Feedback! I encourage you to create a new post in the General Product Feedback topic in our community to engage with other users who have similar needs and discuss possible workarounds. Conversations with a high level of engagement ultimately get flagged for product managers to review when they go through roadmap planning.
We truly value customer feedback and your voice and votes in the forums help influence future Zendesk functionality.
Best,
Paolo | Technical Support Engineer | Zendesk
0
Valentyn
Good Day,
Is there any way to not save attachments (or use linked email attachments) only for tickets generated from our specific mailbox?
Thanks!
0
Paolo
Good day. Apolgies but I'm a bit confused about the use case here. Can you provide some samples? You may also reach out to our Support Team and provide as much information as possible. Our Support Team can provide specific solutions to your concerns. For more information, please refer to this article: Contacting Zendesk Customer Support.
Best,
Paolo | Technical Support Engineer | Zendesk
0