JIRA is now available as three separate applications, JIRA Software, JIRA Service Desk, and JIRA Core. For more information on administering these applications, refer to the Administering JIRA Applications documentation.

Attaching a Screenshot

JIRA allows you to attach screenshots to an issue.

This feature is only available if:

  • Your JIRA administrator has file attachments enabled (you also need the Create Attachments permission in the appropriate projects),
  • You are using a Windows or Mac client (if you use another operating system, you can attach a screenshot using the file attachment feature instead, or for Linux users please see our article for enabling this feature)

Browser compatibility notes: If you are using Internet Explorer versions 8-10, the computer you are using will need to be running Java version 1.7+ platform. If you are using Google Chrome, Mozilla Firefox or Internet Explorer 11, the screenshot capability takes advantage of HTML5 compatibility. Safari is not supported.

On this page:

Capturing screenshots

The method for capturing screenshots differs on each operating system, as described below:

Capturing a screenshot on Windows

  • New screenshot capture — To capture a screenshot onto the system clipboard, use either of the following keyboard combinations:
    • Press ALT-PRINTSCREEN to capture your currently selected window; or
    • Press CTRL-ALT-PRINTSCREEN to capture the whole desktop
  • Existing image — Open your existing image in your favorite imaging application and select the copy option from the appropriate menu to capture the image into the system clipboard.

Capturing a screenshot on Mac OSX

  • New screenshot capture — To capture a screenshot into the system clipboard, use either of the following keyboard combinations:
    • Press CTRL-CMD-SHIFT-4 to capture a selected area of your desktop; or
    • Press CTRL-CMD-SHIFT-3 to capture the whole desktop
  • Existing image — Open your existing image in your favorite imaging application and select the copy option from the appropriate menu to capture the image onto the system clipboard.

Attaching a screenshot

To attach a screenshot:

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

  3. The Attach Screenshot dialog box opens. Note that if you take a screenshot at this point it will include the Attach Screenshot dialog box.

  4. Paste the image from your clipboard using the relevant keyboard shortcut. (For Max OSX use CMD+V, for Windows use Ctrl+V)

  5. Enter a file name for the screenshot you are attaching. (The file name defaults to screenshot-1.)
    (info) A valid file name cannot contain any of these characters: '\', '/','\"', '%', ':', '$', '?', '*'.

  6. Click Upload to attach the captured image to your JIRA issue.

Deleting a screenshot

To delete a screenshot from an issue:

  1. Open the JIRA issue you wish to delete the screenshot from.
  2. Locate the attached screenshot in the Attachments section.
  3. Highlight the screenshot you want to delete by hovering your mouse over it. A trash can will appear at the bottom left side of the screenshot.
    Highlighted attached screenshot

  4. Click on the trash can. A Remove Attachment confirmation box displays.
  5. Click Delete to confirm you want to delete the screenshot.

Known issues

  • IE9's browser security settings may block the Java Applet. To fix this:
    1. Open IE9 and access JIRA. IE will ask if you want to Allow Java add-on -> Click Yes.
    2. Open an issue. From More -> Attach Screenshot -> IE will ask if you want to Allow Applet for JIRA -> Click Yes.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

61 Archived comments

  1. User avatar


    Any time frame when this feature will be available when running linux?

    I don't understand how it matters as your using a java applet to implement the functionality surley the hole point of using the java applet is that its universal?!

    16 Aug 2010
    1. User avatar

      Wojciech Seliga

      Java used to really suck at cross-platform compatibility wrt clipboard support.
      On Linux, pasting image could freeze your applet for ages (many seconds if not minutes).
      That's why I believe this feature is specially disabled on Linux.

      If you are looking for some more portable and convenient way of attaching screenshots to JIRA (and annotating them at the same time), feel free to take a look at a commercial plugin ScreenSnipe for JIRA.

      17 Aug 2010
      1. User avatar


        YouTrack provide great tool for that. And it work on Linux too and fast. So, it just your implementation I thought.

        24 Jan 2013
        1. User avatar

          Wojciech Seliga

          Java support on Linux has improved since then. Still Jetbrains IntelliJ (these guys also developed YouTrack) fails miserably at some circumstances with clipboard-based operations due to an outstanding bug in JDK (don't remember the exact link right now).

          Nonetheless in HTML5 word it's time to forget about using applets for clipboard operations and instead use what Confluence has been successfully using for some time now. It's hopefully coming to JIRA very soon.

          24 Jan 2013
          1. User avatar


            Thanks for the answer. But I think we there do not speak about Jetbrains IntelliJ great IDE where clipboard indeed have some minor strange issues meantime compensated by few other tools (like inner buffer and so on).

            I had spoke there about YouTrack where I have not found such issues at least on first glance.

            And off course I agree what in nowadays HTML5 should be preferred solution for most OS and browsers. Thanks to working on it to bring such functionality for Linux users too.

            16 Mar 2013
  2. User avatar


    This should really work for Linux users, too. There are tons of java or flash solutions. Or, ideally it should work just as drag and drop in Google Docs (HTML5 based?): Just drag any pic from your desktop.

    Anyway: Do not let out Linux users pls.

    01 Dec 2010
    1. User avatar

      Wojciech Seliga

      Or, ideally it should work just as drag and drop in Google Docs (HTML5 based?): Just drag any pic from your desktop.

      But it's already supported by a free JIRA Drag & Drop plugin.
      Give it a try.

      02 Dec 2010
    1. User avatar

      Michael Andreacchio

      This feature can be enabled in Linux, for more information on this please see this Usage FAQ page: How to enable "Attach Screenshot" on Linux Machine

      17 Jul 2012
  3. User avatar


    Why can't you add a screenshot when you create an issue? Why do you have to create the issue and then add the screenshot after?

    08 Feb 2011
  4. User avatar


    hello, I am able to attach a screenshot, viewable within the screenshot pop up window, however when I click on the attach button and am taken back to the jira issue, I can not see the screenshot anywhere.  I am using IE 8.  Any help would be appreciated.  Thank you. Gerald. 

    21 Apr 2011
  5. User avatar


    Same question as the anonymous had 2 posts above. Why can I not create an issue and attach the screenshot which describes the problem there and then? Having to commit the the issue first and then save the screenshot in it is tedious and inefficient.

    09 May 2011
    1. User avatar


      Same questions as Anonymous from Feb 08, 2011 and Anonymous from May 09, 2011:

      Why I can't add a screenshot during the new issue creation? Why I have to create the issue and then add the screenshot after? And why we don't have a ShortCut for "Attach Screenshot" menu item?

      If above functions weren't implemented yet then give us the links to the issues please, to be able to see the progress on them...! Thanks!

      ps. this are very usable things...

      02 Feb 2012
  6. User avatar


    Same problem as the guy on April 21. I attach a screenshot which seems to work without error but when I then look at the issue again afterwards the screenshot is nowhere to be found.

    17 May 2011
  7. User avatar


    Same issue as the three users above. I go to "attach screenshot" use valid characters to name the attachment, click "attach", I am taken back to the issue screen with no attachment. I have to repeat the process for it to finally showup. I always have to attach screenshots twice to get them to show up. No error messages provided by Jira.

    18 May 2011
  8. User avatar


    I've tried several times to attach a screenshot, using Google Chrome ... The paste function works, but after submitting the form, the screenshot is nowhere to be seen within the issue ...

    27 May 2011
    1. User avatar


      Same happened to me. The first time I attached using Attach button, the image did not get attached. Then again I tried with a comment (clipboard was not changed meanwhile), and it got attached. Subsequent attachs even without a comment did work. So I believe it was a momentarily issue, but was annoying to see the feature did not work as expected.

      02 Nov 2011
      1. User avatar


        Sorry, missed my Jira version. (v4.3.1#615-r147022)

        02 Nov 2011
  9. User avatar


    Looks like it was fixed in 4.3.3:


    31 May 2011
  10. User avatar


    Every time I attempt to Attach a screenshot via Chrome (ver 12), I get a prompt to download Java runtimes.  I know I already have the latest but I humor JIRA/Chrome and the installer eventually indicates the version is already installed.  It asks to reinstall, I say "Ok".  I go through the whole procedure of reinstalling.  After it's complete, I attempt to add a screenshot, again, within Chrome.  Same thing, it wants to install the Java run times.

    19 Jul 2011
  11. User avatar

    Chris Keeble

    Recently, when I attach a screenshot using Chrome, the issue no longer 'refreshes' to show the newly attached screenshot. If I manually re-load the page (issue), the screenshot has been successfully attached.

    I have the latest version of the Java runtime installed.

    Does anyone have a solution to this?

    (using JIRA v4.4.5#665-sha1:422aead)

    Kind regards


    09 Mar 2012
  12. User avatar

    Justin Alex [Atlassian]

    For those who are interested in having the option to attach screenshots when creating issues, kindly refer to our feature request here: JRA-5015 - Attach screenshot when creating issue Resolved

    28 Mar 2012
  13. User avatar

    Tommy Bennett

    Has anyone ever been able to print full sized images as part of the "printable view" from a JIRA ticket?

    17 May 2012
  14. User avatar



    I am using Windows XP and Internet Explorer 8. I am no able to attach screenshot. however other people are able to do so. Can you please help me in this.



    09 Aug 2012
  15. User avatar


    You need to attach screenshot twice for the first time and then later screenshots can be added by trying once only. Thats a bug in JIRA.

    I am unable to attach more than 4 screenshots, can see any documentation how many screenshots are supported in JIRA.


    -Chetan Paul

    05 Oct 2012
  16. User avatar

    Chris Keeble

    Accessing our JIRA 5.1.4 installation from a new notebook, on clicking "Attach Screenshot", the user is taken to an Oracle page which is not helpful (http://www.oracle.com/technetwork/java/index.html) - there is no message or information about Java needing to be installed.

    I think it would be helpful if:

    • a message is displayed explaining that the Java JRE is not installed, but is needed to use this feature
    • a link is provided to the Oracle Java SE JRE download page (http://www.oracle.com/technetwork/java/javase/downloads/index.html)
      • brief instructions included on which link to click, i.e. "JRE" Download
    • a link to relevant more info page (this one?) on Atlassian.com is provided

    Have added an issue to jira: JRA-30146

    17 Oct 2012
    1. User avatar


      Any update on this bug?  Really a pain to not be able to add screenshots anymore.

      10 Jan 2013
    1. User avatar


      I believe that's related to a Java 7/64 bit issue and Chrome is 32 bit.

      30 Jan 2013
      1. User avatar

        Matt Doar (ServiceRocket)

        Attach Screenshot doesn't work for me in Chrome or Firefox on OSX. It's always been a finicky feature of JIRA for me, whatever the OS. I think the use of a Java applet is at the root of many of the problems.

        08 Feb 2013
  17. User avatar


    Most technical users are removing or have removed Java from their browsers as a result of multiple major security vulnerabilities.  There's no reason to use a Java plugin for this functionality.  Recommend updating to a non-Java based uploader.

    28 Mar 2013
  18. User avatar

    Wojciech Seliga

    it's happening - https://marketplace.atlassian.com/plugins/com.atlassian.plugins.jira-html5-attach-images (I hope it to become a complete replacement for old applet image attacher)

    28 Mar 2013
  19. User avatar

    Jonhy Ortiz


    Does anybody know whether is a way to share screenshot between issues?

    The thing is that I have some issues that should have attached the same screenshot, so I was wondering if there is a way to "share" it without attaching the same screenshot file in both issues?.

    04 Apr 2013
    1. User avatar

      Matt Doar (ServiceRocket)

      Not inside JIRA. You could upload to both issues then go into the data/attachments/MYPROJECT/MPYPROJECT-NNN directory for the second issue, and add a soft link to the original screenshot. This isn't a great idea though because deleting it from the original issue will not delete it from the second issue.

      The other approach is to refer to a single location, not using JIRA attachments but a URL instead

      04 Apr 2013
  20. User avatar

    Jonhy Ortiz

    Ok Matt, thanks much for your help and quick response.

    04 Apr 2013
  21. User avatar


    It is not just Create Attachment Permission, it looks like if we need to enter "Update comment" field, we also need the Add Comments permission. As of now we do not allow JIRA comments for any users and as such while attaching screenshot if the user enters any comment, the applet just completes without warning. And you do not see any screenshot on the issue page.

    Since this is an applet, I do not think we can remove the "Update comment" field. So the only option seems to be is to disable to "Screenshot" system plugin.

    03 May 2013
  22. User avatar

    Mauro Fernandez Badii [Atlassian]

    There are known problems with Java 7 and Chrome.
    Read Attach Screenshot not working with Chrome and Java 7 form more details. 

    14 Aug 2013
  23. User avatar


    Worst experience ever. Doesn't work at all. 

    11 Sep 2013
    1. User avatar


      We are using this free simple plugin https://marketplace.atlassian.com/plugins/com.atlassian.plugins.jira-html5-attach-images mentioned early on this page. And it works like a charm for all Windows and Linux users.

      14 Sep 2013
  24. User avatar




    II cannot attach a screenshot. I am directly sent to JAva page http://www.oracle.com/technetwork/java/index.html

    I must probably download pluggin but which one? 



    18 Sep 2013
    1. User avatar

      Mauro Fernandez Badii [Atlassian]


      If using Chrome on Mac, download the 32bits version of latest Java
      There is some documentation on known problems here: Attach Screenshot not working with Chrome and Java 7

      If you run into problems please report the problem with support.atlassian.com



      18 Sep 2013
  25. User avatar


    I attached an image to my case using the 'Attach Image' tool, but I can't see the image anywhere on the case.

    No indication that the upload failed, and no indication that the image is available to use either.

    Really poor experience!

    imgur does image uploads really well. Can you make it more like that service?

    08 Nov 2013
  26. User avatar

    Michael Kornatzki

    it's a shame that atlassian can not provide a solution for this bug which exists since , i am not shure, a year? !!!

    Hey guys this is a commercial product.

    13 Nov 2013
  27. User avatar


    This feature is not working on Firefox or Safari on mac - please fix! I basically need to spend hours more per week clicking and saving screenshots to separate files and then assigning them to tickets with out this feature.


    18 Nov 2013
    1. User avatar

      Susan Griffin [Atlassian]


      If this feature is not working, the best way to get it resolved is to file a bug: https://jira.atlassian.com/.



      18 Nov 2013
  28. User avatar



    I was able to attach snapshots using attach screenshot in JIRA till yesterday. There was a windows update and after this unable to attach screenshot.

    Could you please help me with this on high priority. Error details:

    Java Plug-in

    Using JRE version 1.7.0_51-b13 Java HotSpot(TM) Client VM

    User home directory = C:\Users\XXXXX


    c:   clear console window

    f:   finalize objects on finalization queue

    g:   garbage collect

    h:   display this help message

    l:   dump classloader list

    m:   print memory usage

    o:   trigger logging

    q:   hide console

    r:   reload policy configuration

    s:   dump system and deployment properties

    t:   dump thread list

    v:   dump thread stack

    x:   clear classloader cache

    0-5: set trace level to <n>


    16 Jan 2014
    1. User avatar

      Mauro Fernandez Badii [Atlassian]

      Please contact support.atlassian.com to get technical support and you'll receive a response shortly (smile)


      16 Jan 2014
  29. User avatar


    Latest java version causes securityexception when trying to launch applet.

    17 Jan 2014
  30. User avatar


    We are having the same issue after updating to Java version 7 update 51

    20 Jan 2014
  31. User avatar

    Mauro Fernandez Badii [Atlassian]

    There are known problems with Java 7 and Chrome.

    Please read Attach Screenshot not working with Chrome and Java 7 for more details.

    20 Jan 2014
    1. User avatar


      This is not the know Java 7 and Chrome issue. The new Java version 7 update 51 causes the attach screenshot to malfunction on all browsers.

      31 Jan 2014
  32. User avatar


    We're having the same issue after Java version 7 update 51 came out for both IE and Chrome users.

    04 Feb 2014
  33. User avatar


    I found a workaround: in java settings under control panel, in "security" tab, add an exception for the url site in question and adjut the security levels.

    After doing this, it worked for me.

    17 Feb 2014
    1. User avatar

      Chris Keeble

      Thanks Anonymous. This worked for me too. Detailed steps for anyone unsure:

      • Windows -> Start -> Control Panel -> Programs -> Java (32-bit) 
      • Select the 'Security' tab
      • Click 'Edit site list' button
      • Click 'Add...' button
      • Enter the URL of the site (e,g. http://jira.mycompany.com:1234/ ) and click Add...
      • Click OK...

      Now reload the JIRA edit issue page, click the Attach Screenshot button and it should now work.


      25 Apr 2014
  34. User avatar

    Tuukka Ilomäki

    Hopefully all this discussion about enabling and toubleshooting Java will be made obsolete when JRA-31917 - Rewrite screenshot applet using not-java Closed  is finally fixed.

    28 Apr 2014
  35. User avatar

    Hans-Hermann Hunfeld

    I cannot find an option to add a comment to a screenshot, some users are reporting that this was removed at any update? Using "Add Attachment" has this possibility, but many users are pasting their screenshots via CRTL+V without saving them as file...

    19 Jun 2014
    1. User avatar

      Oswaldo Hernandez [Atlassian] Bugmaster

      Hi Hans-Hermann Hunfeld,

      This is a known limitation in the html 5 based screenshot attachment plugin. Due to usage results derived from analytics and the fact that you can always simply add a comment to the issue we decided to de-prioritise adding this functionality.

      Please feel free to add your vote on and use case at JAP-18 - Ability to add a comment with the screenshot Resolved if you would like to see this implemented.


      Oswaldo Hernández.

      JIRA Bugmaster.


      20 Jun 2014
      1. User avatar

        Hans-Hermann Hunfeld

        Hi Oswaldo,

        thanks for clarification. I added my vote to the mentioned issue as we think this is just a missing feature. While adding attachment you can enter a comment in the same screen, but with screenshots (which is very similar to attachments) it´s not....

        Thanks & regards,

        20 Jun 2014
  36. User avatar

    Christoph Enzinger, Lukas Ruprechter



    We use IE9 (9.0.8112.16421) and Java 1.7.0_72 (build 1.7.0_72-b14) with JIRA 6.2.3 and cant get the Screenshot-Function to work properly.

    The same Problem with Firefox 32.0.3.

    On IE9 we get folowing Error : ClassNotFoundException: com.atlassian.jira.screenshot.applet.ScreenshotApplet.class.

    On Firefox we have to make a Java-Security-Exception and after that we got the same ClassNotFound-Exception.

    So the Screenshot-Funktion is not working at all ...

    As a Workarround we use the Drag and Drop Addon.




    23 Oct 2014
    1. User avatar

      Warren Thompson

      Hi Lukas,

      Thanks for the feedback. I'd suggest raising a support request, and if the support engineer can't help you they will be able to raise a bug for you. 



      26 Oct 2014
  37. User avatar

    David Luke

    Are there plans to re-enable this feature for Mac OS users using Safari (the built-in, default browser)?

    It finally started working again with the Java version, now I am considering moving up from 6.2 to 6.3 only to discover that support for Safari has been taken away again in the new HTML 5 version of the screenshot tool. Seems like a feature regression for Mac OS users---disappointing.

    04 Nov 2014
  38. User avatar

    Oswaldo Hernandez [Atlassian] Bugmaster

    Hi David Luke,

    Unfortunately, it is currently not possible for JIRA to provide html 5 screenshot support for Safari, due to the following bug at https://bugs.webkit.org/show_bug.cgi?id=49141 In summary, Safari just simply doesn't allow access to its clipboard image data.

    Alternatively, clipboard data can not be fetched via applet in the latest JREs produced by Oracle in Mac OS X. This used to work in previous versions of the JRE when it was built by Apple but it relied in internal quicktime apis, this ceased to work when the JRE transitioned from Apple to Oracle.

    In conclusion, there's currently no reliable way to fetch clipboard image data from Safari, and we suggest using either Firefox or Chrome to OS X users that would like to take advantage of this feature.

    Hope the information helps explain the current situation with Safari support.


    Oswaldo Hernández.

    JIRA Bugmaster.


    05 Nov 2014
  39. User avatar



    Have you guys tried using Voila Screen Capture to attach screenshots? I simply use it to quickly snap and attach them without all the added fuss. It's listed here and looks like it does the job. 





    13 Jan 2015
Powered by Confluence and Scroll Viewport