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), and
• The computer you are using to access JIRA uses a Java version 1.6+ platform. (JIRA uses a Java applet to run the Attach Screenshot functionality in a separate browser window.)

On this page:

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 window opens in a new browser window.
   If this is the first time you have used this function, a security warning will also display in a dialog box asking you whether you want to trust the applet or not. Choose Yes.

4. Ensure that you have captured an image to your operating system's clipboard and click the Paste button to paste the image.
5. Enter a file name for the screenshot you are attaching. (The file name defaults to screenshot-1.)
   A valid file name cannot contain any of these characters: '\', '/','\"', '%', ':', '$', '?', '*'.
6. Optional: Enter a comment for the screenshot you are attaching.
   If you have entered a comment, then you can also set the security level for the comment by selecting the appropriate value from the Comment Viewable By: dropdown. (The default security level for the comment is All Users.) The comment is added to the JIRA issue, with the selected security level, when the screenshot is attached.
7. Click Attach to add the captured image to your JIRA issue.

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 into 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-APPLE-SHIFT-4 to capture your currently selected window; or
  • Press CTRL-APPLE-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 into the system clipboard.

Known issues

• Attach screenshot does not work with Java 7 and Chrome. See this KB article.