## Accessibility
Checkbox group renders the child checkboxes inside an element with `role="group"`. The group label is connected to the group, and help text is connected when provided.
### Provide A Group Label
Use `label` to describe the shared question or topic.
```html
Housing
Jobs
Travel
```
The group label should not duplicate every option label. It should explain what the options are about.
### Use Help Text For Extra Context
Use `help-text` for instructions, constraints, or validation feedback.
```html
Housing
Jobs
Travel
```
Keep help text short and actionable.
### Required Groups
Use `required` on the group when at least one option must be selected.
```html
Email
SMS
```
Do not put `required` on each child checkbox for a "choose at least one" requirement. That would mean every option must be selected.
### Validation Feedback
Do not rely on invalid styling alone. Provide clear help text that explains what the user needs to do.
```html
Email
SMS
```
When the group is invalid, the invalid state is also shared with child checkboxes for consistent styling and accessibility state.
### Checkbox Labels
Each child checkbox still needs its own clear label.
```html
Email
SMS
Push notifications
```
Avoid option labels that only make sense visually, such as "Yes" or "This one", unless the group label gives enough context.