Skip to end of metadata
Go to start of metadata

When file attachments are enabled, your users will be allowed to attach files and screenshots to JIRA issues. This requires space on the server for storing the attachments.

File attachments are enabled by default. If you wish, you can configure the way JIRA handles attachments, or disable this feature altogether.


  • your users must also have the Create Attachments permissions to attach files to issues
  • to allow users to attach a file when creating a new issue, you need to ensure that the Attachment field is not hidden within the field configuration(s) associated with the specific issue type(s).

Configuring attachment settings

  1. Log in as a user with the JIRA System Administrators or JIRA Administrators global permission.
    (info) If you do not have the JIRA System Administrators global permission, you will not be able to enable or disable file attachments.
  2. Choose > System. Select Advanced > Attachments to open the Attachment page, which states whether attachments are on or off.
    (tick)Keyboard shortcut: g + g + start typing attachments

  3. Click the Edit Settings button, which opens the Edit Attachment Settings dialog box:
  4. In the Attachment Path field, choose the Use Default Directory option. If you see more attachment path options than what is shown in the screenshot above, please refer to the note below.
    (info) As mentioned above, if you have not logged in as a user with the JIRA System Administratorsglobal permission, then this option will not be available to you.
  5. In the Attachment Size field, specify the maximum attachment size. The default is 10485760 bytes (10 MB). The maximum attachment size is 2147483647 bytes (2 GB).
  6. (Optional) In the Enable Thumbnails field, ensure that ON is selected if you wish to display image file attachments as thumbnails (or miniature previews) when viewing an issue. When this setting is enabled, JIRA automatically creates thumbnails of the following types of image attachments:
    - GIF
    - JPEG
    - PNG
    Please refer to the info note below for more information about thumbnails. If you use Linux, please refer to the Linux note below.
  7. (Optional) In the Enable ZIP Support field, ensure that ON is selected if you wish to view the contents of zip files attached to an issue and allow all files attached to an issue to be downloaded as a single ZIP file.
  8. Click the Update button to update JIRA's attachment settings.
    To attach files to issues, the appropriate users, groups or project roles must first be assigned the Create Attachments permission for the relevant project(s).
    To allow these users or group/project role members to delete their own attached files from issues, they must also be assigned the Delete Own Attachments permission for these projects too.
    There is no need to proceed any further if:
    - the permission schemes used by your project(s) already have the Create Attachments (and Delete Own Attachments) permission, or
    - your project(s) use JIRA's built-in Default Permission Scheme.
    However, if you wish to configure these permissions, proceed with the steps in the section below.

Configuring create/delete attachment permissions

  1. Choose > Issues. Select Permission Schemes to open the Permission Schemes page, which displays a list of all permission schemes in your JIRA system and the projects that use each scheme.
    (tick)Keyboard shortcut: g + g + start typing permission schemes
  2. For each relevant permission scheme:
    1. Click the Permissions link associated with the relevant permission scheme to edit that scheme's permissions.
    2. On the Edit Permissions page, locate Create Attachments within the Attachment Permissions section and click the Add link.
    3. In the user selection options on the right of the Add New Permission page, select the relevant (groups of) users or roles and then click the Add button.

      (tick) To allow these users or group/project role members to delete their own attachments, do not forget to assign them the Delete Own Attachments permission too.

(info) More information about thumbnails:

  • You can configure the Issue Navigator column layout to display the thumbnails in an Images column.
  • All thumbnail images are stored in JPEG format in the attachments directory, together with the original attachments. The thumbnail images are denoted by '_thumb_' in their file names.

(info) Thumbnail image generation on Linux:

  • Your system must have X11 support. This web page details the minimum set of libraries needed to use JDK 1.4.2 under RedHat Linux 9.0.
  • The following java system property must be set: -Djava.awt.headless=true