/
User Guide

User Guide

Overview

The Attachment Manager for Jira is a Forge app that allows Jira users to efficiently search, view, download, and delete attachments in bulk from Jira issues. The app respects user permissions, so you can only operate on attachments that you have the necessary permissions to access and modify. This guide explains how to use the app's features.

Features

  • JQL Search: Search for attachments using Jira Query Language (JQL).

  • Sorting: Sort attachments by filename, author, created date, size, type, or issue key.

  • Pagination: Browse attachments with customizable page size.

  • Bulk Selection: Select all or individual attachments on the current page.

  • Bulk Download: Download selected attachments in one action.

  • Bulk Delete: Delete selected attachments with confirmation.

How to Use

1. Accessing the App

  • Navigate to Jira and look for the Attachment Manager for Jira in the global navigation..

  • Open the Attachments Manager from the app menu.

image-20250725-045342.png

 

2. Searching for Attachments

  • Enter a JQL query in the search box (e.g., project = "PROJ" AND updated > -7d).

  • Press Enter or click the Search button.

  • The app will display all attachments matching your query.

3. Sorting Attachments

  • Click on any column header (Filename, Issue, Author, Type) to sort by that field.

  • Click again to toggle ascending/descending order.

4. Selecting Attachments

  • Use the checkbox in the table header to select/deselect all attachments on the current page.

  • Use individual checkboxes to select/deselect specific attachments.

5. Downloading Attachments

  • Select one or more attachments.

  • Click Download Selected.

  • Your browser will start downloading the selected files.

  • Note: When downloading multiple attachments at once, your browser may block multiple download pop-ups by default. Please allow multiple downloads—usually by clicking the blocked pop-up icon at the far right of your browser's address bar and granting permission.

6. Deleting Attachments

  • Select one or more attachments.

  • Click Delete Selected.

  • Confirm the deletion in the dialog.

7. Pagination and Page Size

  • Use the page navigation buttons to move between pages.

  • Change the number of items per page using the dropdown menu.

Tips

  • Use precise JQL queries to narrow down results and improve performance.

  • For best efficiency, add attachments is not EMPTY to your JQL query to only return issues with attachments.

  • Deleting attachments is permanent. Always double-check your selection before confirming deletion.

Troubleshooting

  • If you encounter errors fetching or deleting attachments, ensure you have the necessary Jira permissions and that your JQL query is valid.

Support

For questions or issues, contact your Jira administrator or email tech_support@xdevpod.com.