Documentation for JIRA 4.2. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

JIRA allows you to attach screenshots you have captured to an issue, if the administrator has configured JIRA and your permissions appropriately.

Icon

This feature is only available if:

  1. Your JIRA administrator has file attachments enabled. (You will also need the 'Create Attachments' permission in the appropriate projects.)
  2. 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.)

On this page:

Attaching a Screenshot

To attach a screenshot:

  1. Open the JIRA issue to which you wish to attach a file.
  2. From the 'More Actions' menu, select 'Attach Screenshot':
  3. The 'Attach Screenshot' page will open 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 the 'Yes' option to trust the applet and access the 'Attach Screenshot' page.
    Icon

    JIRA uses an applet to run the 'Attach Screenshot' functionality in the new browser window.

  4. Ensure that you have captured an image to your operating system's clipboard and click the 'Paste' button to paste the image. Your captured image should display in the blank area above the 'Paste' button.

    Please note that clicking the 'Attach' button before an image has been pasted will not attach anything to the JIRA issue.
  5. Enter a file name for the screenshot you are attaching in the 'File name:' field. The file name will be initially defaulted to 'screenshot-1'.

    A valid file name cannot contain any of these characters: '\', '/','\"', '%', ':', '$', '?', '*'.
    If an invalid file name is entered, an error message will display when the 'Attach' button is clicked and the screenshot will not be attached to the JIRA issue.
  6. Enter a comment for the screenshot you are attaching in the 'Update comment:' field. This is an optional step.

    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 security level for the comment will initially be defaulted to 'All Users'.
    The comment entered will be added to the JIRA issue, with the selected security level, when the screenshot is attached.
  7. Click the 'Attach' button to attach the captured image to your JIRA issue.
    The window will close and you will be returned to your original JIRA issue.
    At any time you may click the 'Cancel' button to close the window without attaching anything to the 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 favourite 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 favourite imaging application and select the copy option from the appropriate menu to capture the image into the system clipboard.