File upload Change history

Date Changed Description
Jul 2026 GOV.UK Frontend v6.4.0

Fixed an error with Ruby on Rails apps and hidden inputs.
Jun 2026 GOV.UK Frontend v6.2.0

Added wrapperClasses and wrapperAttributes parameters to define custom classes and HTML attributes for the wrapper of the improved File upload component.

Changed name of improved File upload component ‘drop zone’ from the govuk-drop-zone to govuk-file-upload-wrapper.

Fixed improved File upload component lacking an error state.
May 2026 Guidance

Added guidance about HTML attributes.
Feb 2026 GOV.UK Frontend v6.0.0

Updated colours to use the new GOV.UK brand palette.

Removed value parameter, since no modern browser supports passing a value to a file input
Oct 2025 GOV.UK Frontend v5.13.0

Added functionality for the improved File upload component to use the multiple attribute.

Fixed long filenames in improved File upload component not wrapping.
Aug 2025 GOV.UK Frontend v5.11.2

Fixed the improved File upload component being hidden with an empty label.
May 2025 Guidance

Removed advice on giving users multiple ways to upload files, which we’d previously included as part of our WCAG 2.2 advice.
Mar 2025 GOV.UK Frontend v5.9.0

Added an improved File upload component which uses a JavaScript enhancement to improve the user experience.
Jan 2024 Guidance

Added advice on giving users multiple ways to upload files to help with meeting WCAG 2.2.

Added advice on preserving previously uploaded files to help with meeting WCAG 2.2.
Aug 2023 Guidance

Added a usability issue to the ‘Known issues and gaps’ section to explain that the input does not show a visual target area when dragging and dropping a file onto the input.
Apr 2023 GOV.UK Frontend v4.6.0

Updated the appearance of disabled form controls.
Added a top-level disabled parameter to form controls.
Sept 2021 GOV.UK Frontend v3.13.1

Added max-width styling to the component to fix an issue with magnification.
May 2021 GOV.UK Frontend v3.12.0

Fixed text alignment in Safari browsers.

Fixed ‘jumping’ on focus.
Jul 2020 GOV.UK Frontend v3.8.0

Updated the error state to no longer include a border around the input.
Jan 2019 Guidance

Added templates for suggested error messages.
Nov 2018 GOV.UK Frontend v2.4.0

Added option to set custom classes on the form group.
Jun 2018 GOV.UK Frontend v1.0.0

Component introduced.