Bulk Attachment Download

Bulk Attachment Download lets you collect every attachment from a Jira issue search into a single ZIP. Open Filters > Search work items or any predefined or saved filter, optionally narrow the result with an attachment filter, choose how files are organized into folders, and download.

Getting Started

To start using the Bulk Attachment Download plugin, you need to install it in your Jira Cloud instance. Follow these steps:

Visit the Bulk Attachment Download listing on the Atlassian Marketplace.
Click on the ‘Try it free’ button in the upper right corner.
Select the Jira Cloud instance where you want to install the add-on and click ‘Start free trial’.
The add-on will be automatically provisioned to your Jira Cloud instance.

Note: The installation process requires administrator rights for your Jira Cloud instance.

Once installed, the plugin integrates seamlessly into your Jira workflow, and you can access its features directly within the platform.

Downloading Attachments

In Jira, open Filters > Search work items or any predefined or saved filter, then open Apps and click Download all attachments.
The dialog that opens shows your JQL search. Refine the download with the Attachment Filter and Folder Structure. The preview table and footer counters update as you change the filter.

The downloaded ZIP will contain every attachment listed in the preview table, with no limit on the number of issues or attachments.

Filtering Attachments

Filtering lets you narrow the download to specific file types, authors, issues, or any combination.

To filter attachments:

Enter your query in the Attachment Filter input field using the format described below.
As you type, the input field provides autocomplete suggestions to help you compose the filter query.
If any part of the filter query is not understood, it will be marked with a red squiggly underline. Hover over the underlined part to see details about the issue.
To apply the filter, press Enter in the text field or click the filter icon rightmost within the input — it becomes active as soon as you change the input.
Once the filter is submitted without errors, the footer statistics and preview table update to reflect the matched attachments, so you can verify the intended result.
Only the filtered attachments will be downloaded. If the filter is empty, all attachments will be downloaded.

Filter query syntax:

Filter queries consist of one or more conditions that attachments must satisfy to be included in the download.
Conditions are formed by combining an attribute, an operator, and a value. For example: mediaType = “Doc”
Supported attributes:
- filename: The name of the attachment file
- mediaType: The general media type (Doc, Audio, Video, Image, Archive, Unknown)
- mimeType: The specific type of the file, such as “application/pdf” for PDF files or “image/jpeg” for JPEG images
- author: The name of the user who uploaded the attachment
- issueKey: The unique identifier of the issue the attachment belongs to, such as “PROJECT-123”
- issueSummary: The title or summary of the issue
Supported operators:
- contains: Checks if an attribute contains a specific word or phrase
- =: Checks if an attribute exactly matches a value
- !=: Checks if an attribute does not match a value
The filter ignores the difference between uppercase and lowercase letters when comparing text.
Multiple conditions can be combined using logical operators:
- AND: Both conditions must be satisfied
- OR: At least one of the conditions must be satisfied
You can use braces () to group conditions and specify the order in which they are evaluated.
Text values should be enclosed in quotation marks ” ”. If a value consists only of letters and numbers, the quotation marks may be omitted.

Examples of filter queries:

Download only image attachments:
mediaType = Image
Download attachments from issues containing the word “bug” in the summary:
issueSummary contains “bug”
Download PDF and Word documents uploaded by a user named “John Doe”:
(mimeType = “application/pdf” OR mimeType contains “wordprocessingml”) AND author = “John Doe”
Download attachments from issues in a project with the key “PROJECT”:
issueKey contains “PROJECT-”

Organizing Attachments

Choose how to organize your downloaded attachments via the Folder Structure dropdown:

No Folders: All attachments are placed directly in the zip file without issue-specific folders. Example: report.pdf
Issue Key Only: Each issue’s attachments are placed in a separate folder named with only the issue key. Example: PROJECT-123/report.pdf
Key + Summary: Each issue’s attachments are placed in a separate folder named with both the issue key and summary. Example: PROJECT-123 Fix login screen/report.pdf
Summary Only: Each issue’s attachments are placed in a separate folder named with only the issue summary. Example: Fix login screen/report.pdf

Preview how files will be organized in the ZIP by enabling the Path in ZIP column in the preview table — it shows the complete path of each file.

File and Folder Naming

Illegal characters. Folder names containing characters that are illegal for file names on certain operating systems (", *, :, <, >, ?, /, \, |) have those characters replaced with _, so the names stay valid across Windows, macOS and Linux.

Duplicate names. When multiple attachments share a name, the plugin appends -N (incrementing) to subsequent occurrences, preserving the original name as much as possible:

Attachment in Jira	File in zip
file-3.txt	file-3.txt
file.txt	file.txt
file.txt	file-1.txt
file.txt	file-2.txt
file.txt	file-4.txt
file-3.txt	file-3-1.txt

Previewing Attachments

The download dialog shows a preview table of every matched attachment directly below the configuration rows, so you can verify what’s about to be downloaded before you commit.

The following columns can be enabled and disabled with the selection dropdown in the upper right of the header:

Name: Displays the file name of the attachment.
Path in ZIP: Displays the full path of the file inside the ZIP, after the naming rules are applied.
Size: Shows the size of the attachment.
Date Added: Indicates when the attachment was uploaded.
Type: Displays the media type of the file (Doc, Audio, Video, Image, Archive, Unknown).
MIME Type: Displays a more detailed media type (eg.: image/png).
Author: Shows the name of the person who uploaded the attachment.
Issue Key: Displays the key of the issue the attachment belongs to.
Issue Summary: Provides the title of the issue.

To sort the attachments by a specific attribute, click on the corresponding table header.

Use the Download button at the right of any row to save that single attachment. Download all in the footer still grabs everything in the table as a ZIP.

Download Progress

Clicking Download all starts the download and shows a progress bar.

Displayed data includes:

The relative and absolute progress of the download.
The total size of all attachments being downloaded.
The names and sizes of the files currently being downloaded.
Any issues encountered.

Note: These indicators only update when an attachment has been completely fetched. The striped pattern within the progress bar represents the sum of all file sizes currently in flight.

Extracting the Downloaded Files

After the download is complete, locate the zip file on your machine and extract it using your preferred file extraction tool to access your attachments. If you encounter issues extracting the zip file with the tools included with your operating system, we recommend using 7zip for Windows and The Unarchiver for Mac.

Two streams of data are recorded:

Audit trail (for you). Each bulk download writes an entry to your site’s logs containing the user’s account ID, the JQL and Attachment Filter verbatim (these may include private content), and the resulting attachment counts and total size.
Telemetry (for Pristine Bytes). Error reports include stack traces, the app version, browser, operating system, and your Jira site URL. Usage analytics include an anonymous session ID, event names, counts, sizes, and a one-way hash of the configuration. JQL and filter contents are excluded from both.

Atlassian grants Pristine Bytes access to both streams by default. To revoke either, open Atlassian Administration, then Site settings → Connected apps → Bulk Attachment Download → View app details, and select Disable log access (audit trail) or Disable analytics access (telemetry). See Atlassian’s Manage third-party apps documentation for details.

Troubleshooting and Support

A few common situations:

No valid licence found — the download is disabled because the trial has expired or no active subscription is attached to this Jira site. Manage the subscription via the Atlassian Marketplace listing.
Download interrupted — closing the dialog or navigating away cancels an in-flight download. Restart from the same JQL.
Attachments skipped — a warning panel at the bottom of the dialog lists the affected files. The installing user usually lacks browse permission for the issue’s project, or the attachment was deleted in Jira.

If your issue isn’t covered above, contact our support team.