Checkboxes change history

Date Changed Description
Sept 2025 GOV.UK Frontend v5.12.0

Follow-up to remove forced indentation in conditionally revealed content, as HTML was still indented when checkboxes were used with a fieldset.

Jul 2024 GOV.UK Frontend v5.4.1

Fixed conditionally revealed content not aligning with the parent checkbox.

Fixed divider text not aligning with inputs when using small checkboxes.

Apr 2024 GOV.UK Frontend v5.3.1

Removed forced indentation in conditionally revealed content, due to rendering issues with whitespace-sensitive content such as textarea elements.

Dec 2023 GOV.UK Frontend v5.0.0

Added hover styles to small checkboxes in forced colours mode.

Jun 2022 GOV.UK Frontend v4.2.0

Added values parameter.

May 2022 GOV.UK Frontend v4.1.0

Fixed the hint text of disabled checkboxes appearing darker than the label.

Dec 2021 GOV.UK Frontend v4.0.0

Changed conditional reveal JavaScript to look for conditionally revealed content in the whole page, rather than just in the current checkboxes element, to fix JavaScript id issues.

Sept 2021 GOV.UK Frontend v3.13.1

Updated focus style to re-add the transparent outline for forced colour mode users.

Jun 2021 Guidance

Updated known issue guidance to include findings from screen reader user testing of conditionally revealed content.

Jun 2021 Guidance

Added guidance to suggest asking ‘filter questions’ to reduce the need for a ‘none’ option.

Jun 2021 GOV.UK Frontend v3.13.0

Added the option to add a ‘none’ parameter to a checkbox list. Other checkboxes in the same group will uncheck whenever a user selects ‘none’.

Added the option to add divider text between items.

Fixed Checkboxes rendering incorrectly in Internet Explorer 8.

Sept 2020 Guidance

Added known issue that that assistive software users are not consistently notified about conditionally revealed content.

Jul 2020 GOV.UK Frontend v3.8.0

Fixed incorrect rendering if the page’s CSS box-sizing was not set to border-box.

Jan 2020 GOV.UK Frontend v3.5.0

Added the option to add custom classes for each item’s hint.

Oct 2019 GOV.UK Frontend v3.3.0

Fixed conditionally revealed content areas still being shown when there’s no content in them.

Jul 2019 GOV.UK Frontend v3.0.0

Updated how the id of the first input in a group is generated to use the exact value of the idPrefix parameter, without the -1 suffix.

Updated focus style to use a thicker border and remove the transparent outline.

Apr 2019 GOV.UK Frontend v2.10.0

Added smaller variant of Checkboxes.

Fixed an edge case where a checkbox could render with two aria-describedby attributes.

Feb 2019 Guidance

Added guidance to advise against pre-checking checkboxes.

Added guidance on how to sort options within a checkbox list.

Jan 2019 GOV.UK Frontend v2.6.0

Fixed conditional reveal functionality being able to reveal content in other checkbox groups on the same page.

Jan 2019 Guidance

Added guidance on positioning inputs relative to their labels.

Nov 2018 GOV.UK Frontend v2.4.0

Fixed single checkboxes not outputting the aria-describedby attribute when showing an error.

Nov 2018 GOV.UK Frontend v2.3.0

Added the option to add custom classes to each item’s wrapping element.

Oct 2018 Guidance

Added guidance to include hint text that tells the user how many options they can select.

Aug 2018 GOV.UK Frontend v1.3.0

Added the option to add custom HTML attributes for each item’s input.

Jul 2018 GOV.UK Frontend v1.2.0

Added the option to add a hint for each item’s input.

Added the option to add custom classes for each item’s label.

Fixed conditionally revealed content being visible when the page is still loading.

Jul 2018 GOV.UK Frontend v1.1.0

Added a transparent outline when an input is focused, to help with visibility in forced colour modes.

Fixed labels extending the full width of the page.

Removed extra spacing from the bottom of labels.

Jun 2018 GOV.UK Frontend v1.0.0

Component introduced.