Apwide File Field runs inside Jira Cloud and is built with the Atlassian Design System and Atlassian UI Kit. We test it against WCAG 2.2 level AA and publish an Accessibility Conformance Report (VPAT® 2.5 INT) on our Trust Center.
Accessibility features
-
Keyboard. You can do everything with the keyboard: attach, rename and remove files, undo a removal, save or discard your changes, download and preview files and templates. Administrators can also configure the field and the Automation action with the keyboard. Use Tab and Shift+Tab, Enter or Space, the arrow keys in the configuration tabs, and Escape to close dialogs or cancel a rename.
-
No dragging needed. Dragging files onto the field is optional. The Add files button opens your system's file dialog and does the same.
-
Labels and names. Buttons and form fields have names that screen readers announce. The buttons of a file include its name, for example "Rename report.pdf", "Remove report.pdf" or "Download report.pdf". A template's button includes the template's title, for example "Download Filling guide". Picture thumbnails say what they do, for example "Show photo.png at full size".
-
Limits stated up front. Under Add files, the field says which file types, sizes and how many files it accepts, for example "Allowed: PDF, PNG. Up to 1.0 MB per file, 2 files max.". Screen readers read this with the button.
-
Messages are announced. Screen readers announce upload progress, uploaded, removed and renamed files, and changes waiting for Save ("report.pdf will be removed when you save"), without moving focus. Rejected files and failed uploads or removals are announced as alerts.
-
Errors. Rejected files are listed in text with the reason, for example "big.pdf — too large (max 1.0 MB)" or "logo.svg — file type not allowed (allowed: PDF)". When deleting files is turned off, the field says so in text.
-
Focus. Keyboard focus stays in the field:
-
After you remove a file, or when the field becomes full, focus moves to the next file's button, or to Add files.
-
When you rename a file, focus moves into the name box, then back to the Rename button.
-
When you open the field for editing on a work item, focus moves into it.
-
-
Renaming. You edit only the name: the extension is shown next to the box and cannot be changed. An empty name is refused with "Enter a file name.", linked to the box. While you rename a file, the rest of the field waits.
-
Dialogs. The picture preview and the confirmation dialogs move focus inside, keep it there while they are open, close with Escape and return focus to the button that opened them.
-
Light and dark themes. The field follows the theme you choose in Jira (Personal settings > Theme). It uses the Atlassian colour tokens, and its text meets 4.5:1 contrast in both themes.
-
Zoom. The file field works at 200% zoom and at a width of 320 px without horizontal scrolling. Long file names are shortened on screen but read in full by screen readers.
-
No time limits. Download links are created when you ask for them, so a page left open never offers an expired link.
Compatibility
-
Browsers: the browsers supported by Jira Cloud. Tested with Chrome and Firefox.
-
Assistive technologies: not yet tested with screen readers, speech recognition or switch access. The app relies on standard HTML and WAI-ARIA, and on Jira's own frames and dialogs.
Known limitations and alternatives
-
Pictures used as templates. The Templates editor does not ask for a description of a picture. A screen reader reads the template's title instead, or its file name when it has no title. Administrators: give picture templates a title that describes them.
-
Errors in configuration forms. In the field configuration and the Automation action, an error is announced when it appears and its field is marked invalid, but the error text is not linked to the field (a limit of Atlassian UI Kit).
-
After closing the editor on a work item. Where focus goes after you close the field's editor on a work item is decided by Jira. Press Tab to continue.
Feedback
Tell us about accessibility problems or ask for help through the Apwide Customer Portal.