Nishil Patel
Nov 12, 2024
6 min read
Learn how to manage file and video attachments in Jira, from uploading files to adjusting settings and configuring permissions. This guide also covers common video attachment issues like failed MP4 uploads, playback glitches, and missing previews, and offers troubleshooting tips to keep your workflow running smoothly.
1.
Introduction
2.
How BetterBugs Can Help
3.
What are Jira Attachments?
4.
Working with File Attachments for Jira Issues
5.
How to Fix Common Issues with Video Attachments
6.
Troubleshooting Other Problems
7.
FAQs
It’s 2025 and it’s absolutely not cool to capture, save, and upload assets to Jira tickets separately. Each bug, each step, each attachment becomes a tedious task of downloading files, ensuring the right formats, meeting size limits, and finally, uploading them—hoping nothing breaks along the way.
It’s a tiresome, repetitive cycle that turns SDLC into a marathon of file management rather than building software. And when you’re trying to centralize all the relevant information, the process only gets more chaotic: searching for links, organizing attachments, and tracking down missing context in a sea of files.
You can simplify video documentation, avoid file compatibility issues, and save time by creating a cohesive, detailed bug report with video context ready for any team member to view and address. With BetterBugs, you can capture full or cropped screenshots, annotate, and share bugs—including video files—in a more streamlined way. Here’s how BetterBugs can make the process easier:
Note: You can even attach spreadsheets—or any type of file—to your BetterBugs bug report.
Jira attachments let you centralize documents, visuals, logs, and other files within issues.
You can add:
Also Read: Issue Types in Jira
Here are some practical workflows for working with attachments in Jira:
Attaching files to Jira issues is straightforward. Here’s how:
There you are. You’ve successfully attached file(s) to the Jira ticket.
To download all the attachments,
Alternatively, you can add files to Jira issues by simply dragging and dropping items. Here’s how:
NOTE: Jira allows up to 2000 attachments per issue. Attachments are typically displayed in a row with previews for each file. When the number of attachments exceeds 150, they are displayed as a list by default. Also, file names cannot contain special characters such as “%”, “$”, “\”, “/”, and others.
Also Read: How to Work with Components in Jira?
Jira supports various file formats, including images, documents, spreadsheets, and video files such as MP4, AVI, and MOV. However, be mindful of the size and format restrictions.
Also, the maximum size for uploading files in Jira can vary depending on the configuration set by the Jira admin. In a free tier Jira account, the default limit for attachments is set to 1024 MB which can be increased to 2048 MB.
To attach a video in Jira,
To access and edit file attachment settings in Jira,
You’re good to go.
Sometimes, you may have to customize attachment settings for projects. You can update the project permissions from the Permission schemes option. Also, you require system admin or Jira admin-level permissions to make any changes.
By default, file attachments are set as per the Default Permission Scheme with the following permissions:
To configure file attachment permissions in Jira:
Let’s work with the “Create Attachment” option here. Same way, you can configure permissions for the other two.
To Add Users, Groups, or Roles, do the following after step 5 from above:
The selected users who can create ticket attachments get added to the list.
To Remove Users, Groups, or Roles, do the following after step 5 from above:
That’s how you configure file attachment settings in Jira.
Also Read: How to Create Automated Workflows in Jira?
Below are common issues you may come across when attaching video files, such as MP4 or other large-sized files to Jira tickets. We’ve also included solutions for each.
If attaching an MP4 fails repeatedly, it might be due to file size limits, unsupported formats, or network issues.
Sometimes, attached MP4 videos may not play within Jira due to browser cache issues, unsupported file formats, or corrupted files. You can use BetterBugs to clear the cache with one click. To do so,
Changes in browser settings, Jira updates, or plugin conflicts might prevent you from attaching or pasting videos to Jira tickets.
Try using a different browser, re-encoding the video, updating your Jira instance, or clearing the browser cache to resolve the issue.
If you still face trouble working with attachments in Jira, consider taking the following steps:
Nishil is a successful serial entrepreneur. He has more than a decade of experience in the software industry. He advocates for a culture of excellence in every software product.
Meet the Author: Nishil Patel, CEO, and Co-founder of BetterBugs. With a passion for innovation and a mission to improve software quality.
We never spam.
Share your experience with the founderhere!