File attachments

Overview

The File Attachments settings allow you to configure file uploads for tickets.
You can control the maximum file size, allowed file types, MIME exceptions, and download behavior.

Where to Find

Go to Support → Settings → General Settings → File Attachments.

How It Works

These settings determine which files users can attach to tickets and how attached files are accessed.
You can restrict file uploads by size and extension. You can also allow specific file types that WordPress normally restricts.

Step-by-Step Guide

Go to Support → Settings → General Settings → File Attachments.
Set the Attachment max file size (MB).
Enter the required file types in Allowed File Extensions (comma-separated).
Add required MIME mappings under MIME Exceptions (One per line).
Select the required Download Behaviour.
Save the settings.

Options / Settings

Attachment max file size (MB)
Defines the maximum file size users can attach to tickets.
For example, enter 2000 to allow files up to 2 GB.

Allowed File Extensions (comma-separated)
Defines which file types users can attach to tickets.
Enter extensions without a dot and separate multiple extensions with commas.
For example:
jpg, jpeg, png, gif, pdf, doc, docx, ppt, pptx, mp4, ogv, 3gp, 3g2, zip, eml, csv, awlic

MIME Exceptions (One per line)
Allows specific file types that WordPress restricts by default.
Enter each file extension and its MIME type on a separate line using this format: extension:MIME type
For example:
csv:text/csv
awlic:text/plain
For file types such as cam, dcm, stl, emb, pes, and jef, you can add their MIME types as follows:
cam:application/cam
dcm:application/dicom
stl:application/sla
emb:application/octet-stream
pes:application/octet-stream
jef:application/octet-stream

Download Behaviour
Defines how attached files are handled when users access them.
Available options are:

Try opening in browser – Attempts to open the file in a new browser tab. Unsupported file types are downloaded instead.
Download – Downloads the file directly without attempting to open it in the browser.

Example

To allow users to upload images and PDF files up to 2 GB:

Set Attachment max file size (MB) to 2000.
Add jpg, jpeg, png, pdf to Allowed File Extensions (comma-separated).
Select the required Download Behaviour.
Save the settings.

Notes / Tips

Enter file extensions without a dot in Allowed File Extensions (comma-separated).
Separate allowed file extensions using commas.
Add each MIME exception on a separate line.
Use the extension:MIME type format for MIME Exceptions (One per line).
Use Try opening in browser when supported files should open in a browser tab.
Use Download when attached files should always download directly.

If you are using a custom file extension and cannot upload the attachment, please create a ticket on this page. We will help you configure SupportCandy to support the file type.