Documentation for JIRA 6.3 EAP developer (EAP) releases only. Not using this? See below:
(JIRA 6.2.x documentation | JIRA OnDemand documentation | earlier versions of JIRA)

Skip to end of metadata
Go to start of metadata

JIRA allows you to attach files to an issue.

Icon

To be able to attach files, your JIRA administrator must have enabled file attachments

On this page:

Attaching a File to an Issue

(info) To attach files to an issue, you need the Create Attachments project permission in that issue's project.

To attach a file to a JIRA issue:

  1. Open the JIRA issue to which you wish to attach a file.
  2. Select More > Attach Files.
  3. The Attach Files dialog box is displayed.
  4. Click Browse to search for your files.

    Icon
    • You can attach more than one file at a time: after you select a file, it will appear at the top of the 'Attach Files' dialog box, followed by each subsequent file you add.
    • If you use Firefox 3.6 or later or Chrome browsers, you can select multiple files in the browser dialog box.
    • If you select a file by mistake, clear its check box to prevent the file from being attached to the issue.
    • By default, the maximum size of any one file is 10MB, although this limit can be customized by your JIRA administrator. See Configuring File Attachments for more information.
    • File names cannot contain any of these characters: '\', '/','\"', '%', ':', '$', '?', '*'.
  5. Optional: Enter a comment about the files(s) you are attaching.
    (info) If you enter a comment, then you can also set the security level for the comment by selecting the appropriate value from the padlock icon dropdown. The security level for the comment is 'All Users' by default.
  6. Click the Attach button. All selected files will be attached to the issue.

Viewing an Image Gallery

By default, JIRA displays image files (ie. GIFs, JPGs, PNGs) attached to an issue, including any screenshots, as thumbnails.

(info) If your JIRA administrator has disabled Thumbnails in JIRA's Attachment Settings, then the image files will be part of the list of attached files instead.

Click on an image's thumbnail to preview a larger version of it in a popup. If multiple images are attached to an issue, click the left and right arrows to see previews of the adjacent attached images.

Sorting Attachments

You can sort the list of attachments on JIRA issues in ascending or descending order according to the attachment file name or date of attachment to the issue.

To sort your list of attachments:

  1. Open a JIRA issue with attachments.
  2. Click the down-arrow icon to the right of the Attachments section and select the required sort criteria or order options provided in the list.
    (info) Your final sort criteria and order options will also apply to image thumbnails and all subsequent issues viewed.

Accessing ZIP-format File Contents

When viewing an issue, JIRA allows you to browse and access the contents of any ZIP-format file (such as those with a '.zip' or '.jar' file name extension) attached to an issue.

To browse the contents of a zipped attachment and access its files:

  1. Open a JIRA issue with an attached zipped file.
  2. Click the right-arrow icon to the left of the zipped file's name.
  3. The contents of the zipped file are listed. From this expanded list, you can access the zipped file's individual files by clicking their linked names or you can download the whole zipped file in its entirety by clicking the Download Zip link.
    (info) If a file is located within a subdirectory of the zipped file, then the path to that file is indicated in the content of the zipped file. For example, the content of Files.zip listed in the screenshot above shows that File 5.txt is located within the Folder 1 subdirectory of Files.zip.

(info) If your JIRA Administrator has disabled ZIP support in JIRA's Attachment Settings, then this feature will not be available and you must download the zip file to your computer before accessing its individual files.

Exporting All Attachments as a ZIP File

To download all the files attached to an issue as a single ZIP file:

  1. Open the JIRA issue from which you wish to export all attachments as a zip file.
  2. Click the down-arrow icon to the right of the Attachments section and select Download All from the dropdown menu.

Removing a File Attachment from an Issue

(info) To remove attachments from an an issue, you need either of the following the project permissions in that issue's project:

  • Delete Own Attachments — to delete files which you have added to the issue.
  • Delete All Attachments — to delete files which anyone has added to the issue.

To remove a file attachment from a JIRA issue:

  1. Open the JIRA issue from which you wish to remove a file.
  2. Click the down-arrow icon to the right of the 'Attachments' section and select Manage Attachments from the dropdown menu.
    The Manage Attachments page will appear:

    (info) Note: Only users with the appropriate Delete Issues project permissions can remove attachments.
  3. Locate the file you wish to delete and click the Delete Attachment icon:

32 Comments

  1. How to attach files after issue is closed ?

    1. Anonymous

  2. Hi all,

    Why there is no possibility to delete a few selected items and "Delete All" option?  It's very useful for managing with huge amount of attachments.

    Probably there is some tricks for this? But I didn't find it in administration menu. Any ideas?

  3. Anonymous

    It would be nice if tarball (i.e. .tar) and even compressed tarball (i.e. .tar.gz, .tar.bz2) attachments were given the same treatment as zip files in terms of being able to access their contents from within Jira.  I suppose one could add RAR (i.e. .rar) to that list as well, although I would rate it way below handling tarballs.

  4. Anonymous

    Can you attach files to individual comments?

  5. Anonymous

    Perhaps some notation on this documentation page indicating the reason for this message (received when visiting the Manage Attachments page) would be useful to us users:  "Only users with administrative privileges to remove an issue can remove attachments."

    1. Hello there,

      Thanks for the suggestion. The documentation above has been amended to clarify what project permissions are required to delete attachments and an explanation has been provided to (hopefully) better explain that page description.

      I've logged JRA-27233 - Wording improvement on 'Manage Attachments' page - existing description is not clear. Resolved as an improvement request for the existing wording.

      Cheers,

      Giles.

  6. I wonder if I can share attachments that are common to different stories or issues

    1. We place attachments and other issues into our Confluence repository, then link to them.  It's easier for the graphics team to manage images like this, which may be applicable to different issues.  However, there is no easy way to create this link.  You basically have to have a web page open to confluence in one tab, and the JIRA ticket in another, then copy and paste the link into the ticket (or create a web link).  It's the same thing I've done using bugzilla for years. 

      It's unfortunate that creating a link from a JIRA issue does not allow you to link directly to a Confluence attachment other than by referencing the URL.  I would like it if the integration between JIRA and Confluence were tighter here.

  7. How can I edit an attachment from JIRA v4.4? Any idea?

  8. Kwang Whee

    you have to have the right to manage attachment, then you need to delete it and upload the new one.

  9. Anonymous

    Error rendering 'com.atlassian.jira.jira-view-issue-plugin:attachmentmodule'. Please contact your JIRA administrators.

    What can i do for this problem:

  10. Anonymous

    Could someone please inform me of how I can reach the <Browse...> button in the Attach files window? When focus is on Browse button and I press enter, an error message occur, it seems like the attach button is actually sent, not the browse button. I tried different alternatives, like shift + enter and ctrl + enter and arrow keys + enter. Nothing comply, neither alt+w. Please enlighten me.

  11. Anonymous

    Is it possible to track version of the uploaded files ? In the confluence there is functionality that in case we upload file with the same name the new version of the file will be automatically created on the server.

     

  12. Anonymous

    Hello,

    When I select a file to attach in the create issue screen, I get this message: "Cannot attach file screenshot.jpg: Project with id:'10200' not found'".

    Steps:

    1. Log in into JIRA as a jira-user.
    2. Follow "Create issue" link.
    3. Browse local hard drive to select a file to attach.
    4. Select the file screenshot.jpg.

    The system prints out the message above, even before I press the 'Create' issue button.

    The system is running on:

    • JIRA 5.1#768
    • Windows 7.
    • HSQL Database (built-in database).
    • Evaluation licence.
    • Attach global permission is set to ON.
    • Attach permission is set to true for that user.
    Could someone please tell me what's wrong.

    Thanks in advance.

    1. Anonymous

      I've found the cause. Is due to the web browser:

      • Chrome 22.0 DOESN'T work.
      • Internet Explorer 9.0 DO work.

      Regards.

  13. Anonymous

    Hi,
    anybody know how to add thumbnails (in comment) to attached fiels that contain - and spaces in it's name

    I get a "Unable to render embedded object: File (TEST_AAA-5030_My File.png) not found." when i specify it as "!TEST_AAA\-5030_My File.png|thumbnail!"

    1. if you bought the jira, create a ticket for their support. they should resolve your issue in several days.

  14. Hi,

    is any way to access preview for attached files instead of downloading them?

    tx

  15. Anonymous

    Evden eve nakliyat hizmetinde siz seçgin müşterilerimize en kaliteli, en güvenilir ve en hızlı hizmeti sunabilmek için kendini hergün yenileyen firmamız bu konuda yaptığı her başarılı işte birçok kurum,kuruluş ve şahısları kendine hayran bırakmıştır. Nakliyat
    İstanbul'da evden eve nakliyat için nakliyat firması aradığınızda sizlere yardımcı olmaya hazırı

  16. Do you have any idea, what could help, if JIRA doesn't show the attached files to an issue?

    In attachment configuration are all options enabled.

  17. Hi all,

    Does someone know how to customise the JIRA tool in order to open the attached file in the issue when this issue is displayed on doc format

  18. Anonymous

    Hello.

    I need that a client can attach some files when he is creating issues, but I can give him "Browse project" permission.
    How Can I do that? 

    1. Anonymous

      Hi,

      which version do you use because the version 5.2.10 allows you to attach file when creating an issue

  19. Anonymous

    To attach a file to a JIRA issue:

    1. Open the JIRA issue to which you wish to attach a file.
    2. Select More > Attach Files.

    Where is "More"

  20. Is it possible to apply viewing restrictions to an attachment, similar to comments?

  21. Anonymous

    Is it possible to attach a file to a project? I need to upload a style guide for the project my team is working on and I don't see anywhere for me to do this

  22. Anonymous

    Is it possible to attach and view pdf files inside a project?

  23. Anonymous

    Similar to a comment above.  Is it possible to attach a file in JIRA Agile to the entire project.  Maybe something that would show up on the Project page - alongside the Summary, Reports, and Activity Stream?

  24. Anonymous

    Feature request: Ability to add attachments to JIRA issues via a unix friendly, non-GUI interface.

    In our shop, when an issue occurs in our product, QA generates a zip file of logs. They are generated on the product machines themselves which run Linux. Currently, they have to go through a lot of steps to finally get that zip file attached to the JIRA issue. It would save a lot of time if they could upload the logs.zip to the JIRA issue directly from the Linux machine.

  25. Maybe you can create a script witch gathers the information and sends the log to jira via email. So you only have to connect the issue created for the correct daily log and the related jira issue in the frontend. If you add this as cron job no server interaction is needed. If you don’t need/want daily logs, you portably can modify the script to enter the jira issue number and execute the script manually on server.