Configuring File Attachments
| 
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.
| |
| | |
- Login as a user with global administrator access.
-
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:


- On the panel on the left, under the title "Global Settings", click on the link labelled "Attachments".
-
You will be shown a status page stating whether attachments are on or off:
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.
- Go to the Administration Page.
- Go to the "Permission Schemes" page, accessible from under "Schemes" in the navigation pane on the left of
the screen.
-
In the permission scheme for relevant projects, click the "Permissions" link to edit the scheme.
-
In the Permission drop down, find "Create Attachments", and click "Add".
-
In the User Group drop down, select an appropriate group, eg "Anyone" or "jira-users".
|
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'
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.