Mark file upload ‘value’ parameter as deprecated

alphagov · Sep 16, 2024 · 568f013 · 568f013
1 parent 0dce9aa
commit 568f013
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 1 deletion.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,14 @@ For advice on how to use these release notes see [our guidance on staying up to
 
 ## Unreleased
 
+### Recommended changes
+
+#### Stop setting a `value` for File upload components
+
+The File upload component allows passing a `value` parameter, which is used to populate the `value` HTML attribute of the input.
+
+No modern browser supports passing a `value` to a file input, so we've decided to deprecate this parameter. It will be removed in a future version of GOV.UK Frontend.
+
 ### Fixes
 
 We've made fixes to GOV.UK Frontend in the following pull requests:

diff --git a/packages/govuk-frontend/src/govuk/components/file-upload/file-upload.yaml b/packages/govuk-frontend/src/govuk/components/file-upload/file-upload.yaml
@@ -10,7 +10,7 @@ params:
   - name: value
     type: string
     required: false
-    description: Optional initial value of the input.
+    description: Deprecated. Optional initial value of the input.
   - name: disabled
     type: boolean
     required: false