Jira attachment size limit
Jira Cloud allows attachments up to 1 GB per file by default. Admins can raise it to at most 2 GB. The Free plan has 2 GB of file storage in total.
The limits
| What | Limit | Notes |
|---|---|---|
| Per file (default)Admins can change it. | 1 GB | Admins can change it. |
| Per file (maximum) | 2 GB | |
| Free plan storageAll attachments together. | 2 GB per app | All attachments together. |
| Standard plan storagePremium has unlimited storage. | 250 GB per app | Premium has unlimited storage. |
Two limits: one per file, one for the whole site
Jira Cloud checks attachments twice. The per-file limit is a site setting: Atlassian sets it to 1 GB by default, and an admin can lower it or raise it to a maximum of 2 GB. The storage limit is per app and depends on the plan: 2 GB in total on the Free plans of Jira and Jira Service Management, 250 GB on Standard, and unlimited on Premium.
On a Free site, the storage limit is the one that ends up mattering. Every screenshot, log file and screen recording attached to every work item draws from the same 2 GB. A team that attaches a couple of full-resolution screen recordings a day can fill it within weeks, long before any single file comes near 1 GB.
For admins: where the setting lives
You need the Administer Jira global permission. The path in Atlassian's guide is:
- Settings, then System.
- Advanced, then Attachments.
- Edit Settings opens the Edit Attachment Settings dialog.
- In Attachment Size, enter the per-file maximum. Anything up to 2 GB is accepted.
- Optionally turn on Enable ZIP Support, which lets people preview the contents of ZIP attachments and download all attachments on a work item as one ZIP file.
When nobody can attach anything
If the upload button is missing rather than failing, it is a permission or field problem, not a size problem. Attachments are on by default, but a custom permission scheme must grant Create Attachments for the space, and Delete Own Attachments if people should be able to remove their files. For the create screen, the Attachment field must not be hidden in the field configuration used by that work type.
Keeping a Free site under 2 GB
- Screen recordings: run them through /compress-video before attaching. Balanced brings a 1440p capture down to 1080p, which is still sharp enough to read interface text.
- Trim the clip with /trim-video so it only shows the steps that reproduce the bug.
- Screenshots: /convert-to-webp or /compress-image often cut a full screen PNG by a third or more.
- Long PDFs such as specs or vendor reports: /compress-pdf, or link to the document where it already lives.
- Logs: zip them with /create-zip. Plain text compresses very well.
Our test: a 2 minute 1440p screen recording before it goes on a ticket
We made a 2 minute, 2560 x 1440, 30 fps screen capture of a scrolling code editor window (H.264 at about 8 Mbps, no audio), the kind a QA engineer attaches to a bug. We ran it through /compress-video in headless Chromium on the default Balanced setting.
| File size | 113 MB (118,550,385 bytes) | 23.7 MB (24,872,893 bytes) |
| Resolution | 2560 x 1440 | 1920 x 1080 |
| Video bitrate | About 8 Mbps | About 1.7 Mbps |
| Recordings that fit in a Free site's 2 GB | About 17 | About 80 |
| Time to compress | 134 seconds |
Counting 2 GB as 2,000,000,000 bytes and ignoring everything else on the site. Screen content with little motion compresses very well, so the saving on real recordings is usually similar or better.
Error messages and what to do
An upload fails even though the file is well under 1 GB
The site admin has set a lower Attachment Size than the default.
Ask an admin to check Settings, System, Advanced, Attachments, or compress the file below the configured limit.
Uploads fail across the whole site on the Free plan
The site has used its 2 GB of file storage.
Delete old attachments, compress large recordings before attaching, or move to a plan with more storage.
There is no option to attach a file on the create screen
The Attachment field is hidden in the field configuration for that work type.
An admin needs to unhide the field.
People can attach files but cannot remove their own
The permission scheme does not grant Delete Own Attachments.
Add that permission in the space's permission scheme.
Questions people ask
Can an admin raise the limit above 2 GB?
No. Atlassian gives 2 GB per file as the maximum.
Is the 2 GB Free storage shared between Jira and Jira Service Management?
Atlassian describes the limit as 2 GB per app, so each app on the Free plan has its own 2 GB.
Does a ZIP attachment count at its compressed size?
It is a file like any other, so the size that counts is the size of the ZIP you upload.
What does Premium change?
File storage becomes unlimited. The per-file maximum stays at 2 GB.
Also checked for this guide
Make your file fit
Each button opens the tool already set to this limit. Files are processed in your browser.
Good to know
- If an upload fails well under 1 GB, your site admin may have set a lower per-file limit.
- On the Free plan, large screen recordings fill the 2 GB quickly. Compress videos before attaching them.
Sources
- Atlassian Support: Configure file attachments (Jira Cloud) Official page
- Checked on 2026-11-08. Limits change; if a figure looks out of date, use the report button on any tool page.