Checkbox

Checkboxes allow users to select or unselect a given option.

Usage

Checkboxes should be used when displaying less than 7 options. If you require more than 7 options, consider using a select or combobox field instead.

For more best practices on building forms with inputs in Constellation, visit Pega Academy.

Variations

Checkbox

Use a single checkbox for binary selections, such as a decision or affirmation. A user may select and deselect the checkbox as many times as they like. Do not use the checkbox when a user MUST make an active decision, such as yes or no (use a radio group), or if you are expecting the changes to apply instantly (use a switch).

Example

Checkbox group

If there are multiple options to select, wrap the checkboxes in a checkbox group. By doing so, all of the selections made will belong to the same form value. You may also require that users select a certain amount of options to continue.

Example

What do you want to eat?

Checkbox card

A checkbox card can be used to display large volumes of content within a single wrapper. For example, it may include imagery and headings in addition to checkboxes.

Example

Display options

Required

This is useful when a user must select an option to progress further in the application, like when accepting Terms & Conditions.

Configuration

To learn how to configure this component in your Constellation application, visit Pega Documentation.

All components shown on this site are supported by the Constellation design system. To learn how to configure Theme Cosmos, visit Pega Documentation.

Related components