Using the Attachment Field

This guide describes how to work with an Attachment Field custom field already configured by your administrator. If you cannot see the field on your work item screens, contact your Jira administrator — the field may only need to be added to the appropriate screen.

Upload files to the field

When the Attachment Field is part of the Create, Edit, or Transition screen of a work item — or of the JSM portal request form — it appears as a file upload area.

1. Open the create, edit, or transition form for the work item.
2. Locate the Attachment Field (the exact name is defined by your administrator, for example "Invoices", "PQR Evidence").
3. Click Upload file or drag and drop files directly onto the field.
4. Save your changes.

If the files do not meet the configured restrictions (type, size, or count), the field will show an error message before allowing you to save.

Possible error messages

• Maximum file count reached: The field already holds the maximum allowed number of files. Delete an existing file to be able to upload a new one.
• File type not allowed: The file does not belong to any of the categories or extensions configured for this field.
• File too large: The file exceeds the maximum size per file configured for this field.

If you receive any of these messages, verify the type and size of the file you are trying to upload, or contact your administrator for the current limits.

View files on the work item

Once saved, files appear on the work item view inside the field, showing for each one:

• The original filename.
• An icon indicating the file type.
• Preview (eye icon) and download controls.

Each field manages its own files independently. If the work item has multiple Attachment Fields (for example, "Invoices" and "Photographs"), the files in each field are independent and are not mixed between them.

Preview a file

From the work item view, click the eye icon next to the file. A preview opens without downloading the file.

Download a file

From the work item view, click the download button next to the file you want to retrieve. The file will download with its original filename.

Delete a file

Open the work item in edit (or the create / transition screen, if the field is on that screen) and use the delete control for the file you want to remove. You will be asked to confirm before proceeding.

This action is permanent

Deleting a file from the field permanently removes the file from storage. It cannot be recovered once deleted.

Independence between fields and between parent and child work items

Files in an Attachment Field are specific to that field on that particular work item:

• Different fields on the same work item store files separately.
• A parent work item's field does not include the files from its subtasks, and vice versa.

This independence allows document categories to be separated without mixing (for example, a parent work item's invoices do not appear in associated subtasks).

Differences from Jira's native attachments

The Attachment Field works differently from Jira's native attachments panel:

Aspect	Attachment Field (Admin Essentials)	Native Attachments panel
Where they appear	Inside the field, in the work item's fields section	In the work item's "Attachments" panel
JQL	"Field name" is not EMPTY	attachments is not EMPTY
Restrictions	Configurable by administrator (type, size, count)	No per-field restrictions
Independence	Each field is independent	All attachments in a single panel

To find work items that have files in the Attachment Field using JQL, use the field name:

"Invoices" is not EMPTY

The query attachments is not EMPTY does not detect files in the Attachment Field.