Button change history

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

Fixed text spacing when HTML is nested inside of start buttons.

Feb 2026 GOV.UK Frontend v6.0.0

Removed element Nunjucks parameter. Buttons now default to being <button> elements, becoming <a> if the href parameter is set.

Updated Button colours to align with the refreshed GOV.UK brand.

Dec 2023 GOV.UK Frontend v5.0.0

Updated Nunjucks macro to always output an explicit type attribute for <button> elements.

Updated inverse buttons to default to the configured brand colour.

Added customisation of inverse button colours with Sass.

Removed govuk-button--disabled modifier class. Use the disabled parameter instead.

Updated Nunjucks to output the disabled attribute as a boolean attribute.

Jul 2023 GOV.UK Frontend v4.7.0

Added inverse appearance modifier.

Apr 2023 GOV.UK Frontend v4.6.0

Added disabled parameter and updated disabled state appearance.

Added id parameter.

Nov 2022 GOV.UK Frontend v4.4.0

Added customisation of button colours with Sass.

Sept 2021 GOV.UK Frontend v3.13.1

Fixed start button chevron being invisible in forced colour modes.

Fixed buttons with the disabled modifier class still having visible focus style in forced colour modes.

Feb 2021 GOV.UK Frontend v3.11.0

Added button groups.

Fixed additional margins around button in Safari browser.

Oct 2020 Guidance

Added explanation of why start buttons are rendered as links.

Sept 2019 GOV.UK Frontend v3.2.0

Fixed focus style being unreadable when GOV.UK Frontend was used alongside GOV.UK Elements.

Jul 2019 GOV.UK Frontend v3.0.0

Updated the chevron icon on start buttons to use an inline SVG instead of a background image.

Updated button colours to align with the updated colour palette.

Updated focus style to comply with WCAG 2.1.

Apr 2019 GOV.UK Frontend v2.11.0

Added secondary and warning style modifiers.

Mar 2019 GOV.UK Frontend v2.8.0

Added preventDoubleClick parameter and functionality.

Oct 2018 GOV.UK Frontend v2.2.0

Fixed links styled as buttons being draggable.

Aug 2018 GOV.UK Frontend v1.3.0

Removed additional dotted focus outline from Firefox.

Jun 2018 GOV.UK Frontend v1.0.0

Component introduced.