Configuring File Attachments

PDF
PDF

To Configure File Attachments takes two steps. The first step is configuring JIRA to allow attachments. This is a global setting, and requires space on the server to save the attachments in. The second step is to grant the "Create Attachments" permissions to relevant projects (indirectly, by modifying Permission Schemes).

Step 1: Turning on Attachments.

  1. Login as a user with global administrator access.
  2. Bring up the administration page by clicking either on the "Administration" link on the top bar or the title of the Administration box on the dashboard:

    Link to Administration sectionLink to Administration section

  3. On the panel on the left, under the title "Global Settings", click on the link labelled "Attachments".
  4. You will be shown a status page stating whether attachments are on or off:

    Page for enabling attachments

    Attachments can be enabled and configured by editing the configuration. Image attachment thumbnails can also be enabled from this screen.

Step 2: Allowing attachments in a Permission Scheme.

The "Create Attachments" permission now needs to be enabled in the Permission Scheme of projects you wish to enable attachments for.

  1. Go to the Administration Page.
  2. Go to the "Permission Schemes" page, accessible from under "Schemes" in the navigation pane on the left of the screen.
  3. In the permission scheme for relevant projects, click the "Permissions" link to edit the scheme.

    Permission Schemes
  4. In the Permission drop down, find "Create Attachments", and click "Add".

    Adding a permission to a scheme
  5. In the User Group drop down, select an appropriate group, eg "Anyone" or "jira-users".

    Adding a permission to a scheme

Changing the attachment size limit

The default maximum attachment size is 5Mb. This can be changed, but not yet through the web interface (see JRA-2994). To change this, edit atlassian-jira/WEB-INF/classes/webwork.properties and change the webwork.multipart.maxSize parameter.

Attachments on Issue Creation

In order to attach a file on issue creation - it is necessary to:

  • Ensure that the 'Attachment' field is not hidden within the field layout associated with the specifc issue type
  • Enable 'Attachments'

Multiple Attachments

JIRA allows multiple files to be attached to an issue in one operation. From the 'Attach File' page, the user can toggle between multiple and single attachment screens by selecting the 'Attach multiple' files link. The attachment form will retain the multiple/single attachment preference for that specific user for the duration of the user's session or until manually changed.

The number of attachment 'boxes' to be displayed on the multiple attachment screen can be configured through the property jira.attachment.number in the jira-application.properties file. This setting is configured to 3 by default. It is necessary to restart JIRA in order for a property change to take effect.