Getting started

1. Create the field

You need to be a Jira administrator.

1. Go to Settings → Issues → Custom fields and choose Create custom field.
2. Choose Advanced, then File Field, and click Next.
3. Give the field a name (for example "Signed contract") and create it.
4. Add the field to the screens where people should see it, and to the context (projects and issue types) where it applies.

2. Set limits for the field

1. Open the field's Contexts (in the field's ••• menu, Contexts and default value).
2. Choose Edit custom field config for the context.
3. Fill in the settings and click Save:

- Allowed file types: extensions separated by commas, for example pdf, png, docx. Leave empty to allow every type. - Maximum size per file (MB): leave empty for no limit. Jira's own attachment limit still applies. - Maximum number of files: 1 to 25. Empty or invalid means 10.

Each context has its own settings, so the same field can have different limits in different projects.

3. Add files to an issue

1. Open an issue that has the field and edit the field.
2. Click Add files and choose one or more files. The limits for the field are shown under the list.
3. Wait for the uploads to finish, then click Save.

To take a file out of the field, click the × next to it and click Save. The attachment stays on the issue.

Files are added on the issue view and on workflow transition screens. They can't be added while the issue is being created: create the issue first, then edit the field.

4. Make files required

File Fields uses Jira's own tools, so you can require files the way you require any field:

• Always required: in the field's configuration (Settings → Issues → Field configurations), mark the field Required.
• Only on a transition: in the workflow, add the Field required validator to the transition and choose the field. The transition then needs at least one file.

5. Limits to know about

• Files can't be added on the Create issue screen.
• A field holds up to 25 files.
• Jira's attachment size limit applies to every file. For large files, try one file at a time; very large uploads from the browser can fail on slow connections.
• The maximum number of files is also checked by Jira when the issue is saved. Allowed types and maximum size are checked when files are added in the field.
• Deleting the field, or removing a file from it, doesn't delete attachments from the issues.