Skip to main content

Changelog

This page lists notable changes shipped with each release of File Field. The most recent update is shown first.

info

The app is updated through the Atlassian Marketplace. Your Jira Cloud site receives new versions automatically — no manual upgrade is required.

Release: 2026-07-03​

Search files in JQL​

File Field is now fully searchable in Advanced search (JQL), so you can filter issues by what's attached and reuse those queries in saved filters, boards, and automation.

  • Search by file count — find issues that are missing a required document (FileCount = 0) or that carry several, with the field's FileCount alias.
  • Search by file type — filter by broad families such as PDF, Image, Word, or Spreadsheet using FileType.
  • Search by file name — match issues by the words in a file's name with FileName.
  • Search by category — filter by the category a file was given through Categories.
  • Works in automation — the same conditions run in automation rules, for example blocking a move to Done when no file is attached.

See Find Issues by Their Files (JQL) for the full guide.

Release: 2026-07-02​

A refreshed file editor​

We've rebuilt the field's edit experience to make attaching and organizing files clearer and more reliable.

  • File cards with type icons — each file now shows an icon for its kind (image, audio, video, document, and more), so you can tell files apart at a glance in both the editor and the issue view.
  • Simpler category picking — choose a category with one click on a colored label, right next to the file, instead of a dropdown.
  • Cleaner file list — files in the issue view show their name, type, and size, with a download button on each.
  • Safer editing — Save now waits until any in-progress upload finishes, and cancelling an edit no longer leaves the field pointing at a removed file. Files you just uploaded download correctly straight away.

Release: 2026-06-28​

File categories​

Label each file with a colored category, so a single field can hold different document types and keep them easy to tell apart.

  • Per-context categories — enable and define categories independently for each field context. Off by default, so existing fields are unchanged.
  • Six label colors — name a category and pick from Grey, Blue, Green, Red, Purple, or Yellow, with a live preview.
  • Choose on upload — when categories are on, people pick a category before files upload, or leave it as none.
  • Visible everywhere — the colored label shows above the file in the issue view and editor, and is included in Jira exports.
  • JQL search — find issues by category using the field's Categories alias.

See Classify Files with Categories for the full guide.

Release: 2026-06-25​

Initial release​

File Field is a native Jira custom field for attaching multiple files directly to issues and Jira Service Management portal requests.

  • Multiple files per field — attach as many files as the policy allows, all in one named field.
  • Per-context upload rules — administrators set the allowed file types, maximum number of files, and maximum file size independently for each field context.
  • Files stay inside Atlassian — built on Atlassian Forge; nothing is sent to external or third-party services.
  • Permission-aware — every upload, download, and delete is checked against the user's Jira permissions.
  • JSM portal support — customers can attach files when raising or updating a request from the customer portal.
  • Required field support — the field works with Jira's standard field configuration, so it can be made mandatory on any issue type.
  • Works everywhere — issue view, create-issue form, workflow transition screens, and the JSM customer portal.