# Simple Bulk Attachment Downloader - User Guide

Related blog post: [Bulk download Jira attachments in one click](/blog/bulk-download-jira-attachments.md)

Welcome to Simple Bulk Attachment Downloader! This guide will help you quickly download all attachments from your Jira issues in just a few clicks.

## 🚀 Quick Start[​](#-quick-start "Direct link to 🚀 Quick Start")

### What This App Does[​](#what-this-app-does "Direct link to What This App Does")

* **Downloads all attachments** from Jira search results as a single ZIP file
* **Organizes files automatically** by issue in clean folder structure
* **Works 3x faster** with parallel downloading technology
* **Integrates seamlessly** with Jira's issue navigator

### Before You Begin[​](#before-you-begin "Direct link to Before You Begin")

* Ensure you have the app installed in your Jira instance
* You need **read access** to the issues containing attachments you want to download
* The app works with any Jira search results or saved filters

***

## 📋 How to Use[​](#-how-to-use "Direct link to 📋 How to Use")

### Step 1: Navigate to Your Issues[​](#step-1-navigate-to-your-issues "Direct link to Step 1: Navigate to Your Issues")

1. Go to **Issues** → **Search for Issues** in Jira

2. Use any search method:

   <!-- -->

   * **Quick Search**: Type keywords in the search bar
   * **JQL Query**: Use advanced Jira Query Language
   * **Saved Filters**: Select from your existing filters
   * **Project Browse**: Browse issues by project

### Step 2: Find the App[​](#step-2-find-the-app "Direct link to Step 2: Find the App")

1. Once you have your search results displayed, look for the **Simple Bulk Attachments Downloader** button
2. The button appears in the **issue navigator toolbar** (top of the search results)
3. Click the **Simple Bulk Attachments Downloader** button

![Screenshot: App Button Location](/assets/images/highlight1-cb35803d57e441e09f0b77405b5b8eb9.png)

### Step 3: Review Attachment Summary[​](#step-3-review-attachment-summary "Direct link to Step 3: Review Attachment Summary")

The app will automatically analyze your search results and show:

* **Issues found**: Total number of issues in your search
* **Total attachments**: Number of files that will be downloaded
* **Total size**: Estimated download size in MB
* **Filter context**: Shows the JQL query being used

![Screenshot: Analysis Results](/assets/images/highlight2-8f5a4a4475804d848fda60b92532a023.png)

### Step 4: Download Attachments[​](#step-4-download-attachments "Direct link to Step 4: Download Attachments")

1. Click the **Download X Attachments as ZIP** button
2. Watch the **real-time progress** as files are downloaded in parallel
3. Your browser will automatically start downloading the ZIP file when complete

### Step 5: Access Your Files[​](#step-5-access-your-files "Direct link to Step 5: Access Your Files")

1. Open the downloaded ZIP file (usually in your Downloads folder)
2. Files are organized in folders by issue: `ISSUE-123 - Issue Summary`
3. Each folder contains all attachments from that specific issue

![Screenshot: ZIP File Structure](/assets/images/highlight3-fa8c6e45d4bf41e6f4fdb04c8ce31487.png)

***

## 🎯 Use Cases[​](#-use-cases "Direct link to 🎯 Use Cases")

### For Project Managers[​](#for-project-managers "Direct link to For Project Managers")

**Collecting Deliverables**

* Search for issues in your project: `project = "MY-PROJECT"`
* Download all deliverables, documents, and assets in one go
* Share organized folders with stakeholders

### For QA Teams[​](#for-qa-teams "Direct link to For QA Teams")

**Gathering Test Evidence**

* Filter by test execution issues: `labels = "test-execution"`
* Download all screenshots, logs, and test artifacts
* Archive evidence for compliance or reporting

### For Support Teams[​](#for-support-teams "Direct link to For Support Teams")

**Case File Management**

* Search support tickets: `project = "SUPPORT" AND created >= -30d`
* Download customer-provided files, logs, and screenshots
* Create organized case archives

### For Development Teams[​](#for-development-teams "Direct link to For Development Teams")

**Release Preparation**

* Filter by release version: `fixVersion = "1.2.0"`
* Download all documentation, specs, and assets
* Package release artifacts efficiently

***

## ⚡ Advanced Features[​](#-advanced-features "Direct link to ⚡ Advanced Features")

### Smart Parallel Downloads[​](#smart-parallel-downloads "Direct link to Smart Parallel Downloads")

* **3-8x faster** than manual downloading
* **Automatic concurrency control** optimizes speed based on file count
* **Progress tracking** shows real-time download status
* **Error handling** creates error files for failed downloads

### Intelligent Organization[​](#intelligent-organization "Direct link to Intelligent Organization")

* **Folder structure**: `Issue-Key - Issue Summary/attachments`
* **Original filenames** preserved
* **Duplicate handling** maintains all files even with same names
* **Clean naming** removes invalid characters for file system compatibility

### Seamless Integration[​](#seamless-integration "Direct link to Seamless Integration")

* **Works with any JQL query** or saved filter
* **No configuration required** - works immediately after installation
* **Respects permissions** - only downloads attachments you can access
* **Browser-native downloads** - uses your browser's download manager

***

## 🔧 Troubleshooting[​](#-troubleshooting "Direct link to 🔧 Troubleshooting")

### No Attachments Found[​](#no-attachments-found "Direct link to No Attachments Found")

**Problem**: App shows "0 attachments" even though you see attachments in issues

**Solutions**:

1. **Refresh the analysis** - Click "Refresh Analysis" button
2. **Check permissions** - Ensure you can view the attachments in individual issues
3. **Verify search results** - Make sure your search actually returns the expected issues

### Download Fails or Stops[​](#download-fails-or-stops "Direct link to Download Fails or Stops")

**Problem**: Download progress stops or ZIP file is incomplete

**Solutions**:

1. **Check network connection** - Ensure stable internet connection
2. **Try smaller batches** - Narrow your search to fewer issues
3. **Browser storage** - Clear browser cache and try again
4. **File size limits** - Very large downloads (>1GB) may timeout

### ZIP File Won't Open[​](#zip-file-wont-open "Direct link to ZIP File Won't Open")

**Problem**: Downloaded ZIP file appears corrupted or won't extract

**Solutions**:

1. **Re-download** - Try downloading again
2. **Different extraction tool** - Try a different ZIP utility
3. **Check file size** - Ensure download completed fully
4. **Browser issues** - Try a different browser

### App Button Missing[​](#app-button-missing "Direct link to App Button Missing")

**Problem**: Can't find the Simple Bulk Attachments Downloader button

**Solutions**:

1. **Check installation** - Verify app is installed in your Jira instance
2. **Refresh page** - Reload the issue navigator page
3. **Check permissions** - Ensure you have access to use Forge apps
4. **Contact admin** - Your Jira admin may need to enable the app

***

## 📊 Performance Tips[​](#-performance-tips "Direct link to 📊 Performance Tips")

### Optimize Download Speed[​](#optimize-download-speed "Direct link to Optimize Download Speed")

* **Stable connection**: Use wired internet when possible for large downloads
* **Close other tabs**: Reduce browser memory usage during downloads
* **Batch processing**: For 100+ attachments, consider filtering by date ranges

### Manage Large Downloads[​](#manage-large-downloads "Direct link to Manage Large Downloads")

* **Size estimation**: Check total size before downloading
* **Storage space**: Ensure adequate disk space (ZIP files are compressed)
* **Time planning**: Large downloads may take several minutes

### Best Practices[​](#best-practices "Direct link to Best Practices")

* **Regular cleanup**: Delete old ZIP files to save disk space
* **Organized searches**: Use specific JQL queries to get exactly what you need
* **Permission check**: Verify access before starting large downloads

***

## 🆘 Support[​](#-support "Direct link to 🆘 Support")

### Getting Help[​](#getting-help "Direct link to Getting Help")

* **Documentation**: Check this user guide first
* **Jira Admin**: Contact your Jira administrator for installation issues
* **App Support**: Use the support channels provided in the Atlassian Marketplace

### Reporting Issues[​](#reporting-issues "Direct link to Reporting Issues")

When reporting problems, please include:

* **Jira version** and **browser type**
* **Search query** or filter used
* **Number of issues** and **attachments** involved
* **Error messages** or **screenshots** of the problem
* **Steps to reproduce** the issue

### Feature Requests[​](#feature-requests "Direct link to Feature Requests")

We're always improving! Suggest new features through:

* **Marketplace reviews** - Leave feedback on the app listing
* **Support channels** - Contact us through official support
* **Community forums** - Discuss with other users

***

## 🎉 Tips for Success[​](#-tips-for-success "Direct link to 🎉 Tips for Success")

### Maximize Efficiency[​](#maximize-efficiency "Direct link to Maximize Efficiency")

1. **Use saved filters** for recurring download needs
2. **Combine with JQL** for precise attachment targeting
3. **Schedule regular downloads** for ongoing projects
4. **Share ZIP files** directly with team members

### Organize Your Workflow[​](#organize-your-workflow "Direct link to Organize Your Workflow")

1. **Create naming conventions** for your searches
2. **Use date ranges** to manage file volumes
3. **Archive old downloads** to keep workspace clean
4. **Document your processes** for team consistency

### Power User Tricks[​](#power-user-tricks "Direct link to Power User Tricks")

1. **Bookmark complex JQL queries** for quick access
2. **Use labels and components** to categorize attachments
3. **Combine with Jira automation** for advanced workflows
4. **Export attachment lists** before downloading for planning

***

## 📈 What's Next?[​](#-whats-next "Direct link to 📈 What's Next?")

### Upcoming Features[​](#upcoming-features "Direct link to Upcoming Features")

* **Custom folder structures** - Choose your own organization
* **Selective downloads** - Pick specific attachments
* **Scheduled downloads** - Automatic recurring downloads
* **Integration APIs** - Connect with other tools

### Stay Updated[​](#stay-updated "Direct link to Stay Updated")

* **App updates** are automatic through Atlassian Marketplace
* **New features** will appear in your existing installation
* **Release notes** available in the marketplace listing

***

**Happy downloading! 🎉**

Was this helpful?👍 Yes👎 No