From fd1c7231a34bb1ca3cc2530121603f68b913cd0b Mon Sep 17 00:00:00 2001
From: beeps <kimberly.grey@digital.cabinet-office.gov.uk>
Date: Mon, 15 Jan 2024 16:09:21 +0000
Subject: [PATCH] Deprecate 'element' param on button

---
 CHANGELOG.md                                           | 10 ++++++++++
 .../src/govuk/components/button/button.yaml            |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index dba540a2bb..6561183f8f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -98,6 +98,16 @@ This is an experimental change, based on our hypothesis that `govuk-font-size` a
 
 This change was introduced in [pull request #4291: Rename `govuk-typography-responsive` to `govuk-font-size`](https://github.com/alphagov/govuk-frontend/pull/4291)
 
+### Deprecated features
+
+#### Stop using the `element` parameter on buttons
+
+We have deprecated the `element` Nunjucks parameter and will remove it in the next major release.
+
+In the future, the component will automatically use the use the `<a>` element if the `href` parameter is set, or the `<button>` element otherwise, without the ability to override it.
+
+This change was introduced in [pull request #4646: Deprecate `element` parameter on button component](https://github.com/alphagov/govuk-frontend/pull/4646)
+
 ### Fixes
 
 We've made fixes to GOV.UK Frontend in the following pull requests:
diff --git a/packages/govuk-frontend/src/govuk/components/button/button.yaml b/packages/govuk-frontend/src/govuk/components/button/button.yaml
index cb30f70d83..15ca110a24 100644
--- a/packages/govuk-frontend/src/govuk/components/button/button.yaml
+++ b/packages/govuk-frontend/src/govuk/components/button/button.yaml
@@ -2,7 +2,7 @@ params:
   - name: element
     type: string
     required: false
-    description: HTML element for the button component – `input`, `button` or `a`. In most cases you will not need to set this as it will be configured automatically if `href` is provided.
+    description: HTML element for the button component – `input`, `button` or `a`. In most cases you will not need to set this as it will be configured automatically if `href` is provided. This parameter will be removed in the next major version.
   - name: text
     type: string
     required: true