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

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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport