Attaching files and screenshots to issues

Still need help?

The Atlassian Community is here for you.

Ask the community

To share information with your team, you can attach documents, images, and screenshots to your Jira application issues. 

Multiple files can be attached to an issue. Click an image thumbnail to open a preview, and if there is more than one image in the gallery, navigate to the next image preview by clicking the right arrow in the preview.

On this page:

Before you begin

A Jira admin must enable specific user permissions so that you can add attachments and screenshots to issues. The most common permissions are described below. To learn more about this check out Configuring file attachments.

Jira admin set permissions

  • You can attach files and screenshots if your Jira admin has enabled file attachments.
  • You need the Create attachments permission in the appropriate projects.
  • If your Jira admin has disabled thumbnails in Jira's attachment settings, the image files will appear as a list.
  • If your Jira admin has disabled ZIP support in Jira's attachment settings, the attachments feature will not be available. You must download the file to your computer before accessing its individual files.
  • To remove attachments from an issue, you need one of the following project permissions in that issue's project:
    • Delete own attachments—to delete files that you have added to the issue.
    • Delete all attachments—to delete files that anyone has added to the issue.


Browser capabilities
  • If you're using Google Chrome, Mozilla Firefox, or Internet Explorer 11, attaching screenshots relies on HTML5 compatibility. 

Add attachments

You can add files and images to any issue in your service desk project. When working on an issue, simply drag and drop a file onto the issue, or select More > Attach files. You will then have the option to add a comment with more information about the attachment, and then share the file and comment with your customer or with your internal team only.

When adding or editing a comment, you can also select  to add attachments. In this case, you'll see wiki markup added to the comment field. As soon as you share your comment, you'll see the file preview.

You can add file and image attachments to any issue. To add an attachment when you first create an issue, copy a file from your computer and paste it directly in the Create Issue dialog. 

Make sure that you paste the image outside the Description box.

To add attachments to an existing issue, open the issue and follow these steps: 

  1. Click More > Attach files.
  2. Add a file(s).
  3. Click  Attach  or Open.

You can also drag and drop files onto an issue to attach them.


Some considerations for attached files:

  • File formats: GIFs, JPGs, PNGs
  • File names can't contain any of these characters: '\', '/','\"', '%', ':', '$', '?', '*'.
  • By default, the maximum size of any one file is 10MB, although this limit can be customized by your Jira admin.

When you’re uploading an attachment, an error message might display under it, notifying you that the file extension isn’t allowed. This means that your admin has restricted the upload of files in particular formats. Try uploading your file in a different extension or contact your admin.

Sort and manage attachments

The attachments section of the issue displays a list of options to sort, manage, and download attachments.

  1. Select the three dots to the right of the attachments section to open the menu.
  2. Reorder the attachments according to a selected criteria. This criteria will be applied to all issues in your project, and will be lost once you log out.
  3. To remove attachments from the issue, select Manage attachments or hover over the attachment and select the bin icon.

Attachments section of an issue.


Access ZIP file contents

You can view the contents of a ZIP file (including '.zip' or '.jar' file name extensions) in the attachments section.

  1. Click the three dots and select List.
  2. In list view, click the arrow icon in front of the zipped file's name to view and download its individual files. 
  3. To download the entire zip file, click Download Zip.

List of attachments in an issue.


Capture and attach screenshots

You can capture a screenshot to the system clipboard and paste it directly onto an issue.

  1. Capture a screenshot using your system keyboard shortcut.
  2. Paste the image from your clipboard onto the issue using your system keyboard shortcut or right-click menu. The Attach screenshot dialog will display.
  3. Enter a unique filename for each file.
  4. Select Upload.
Last modified on Mar 21, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.