Checkbox Group

The Avonni Checkbox Group component displays a set of selectable choices — rendered as a default list, a button group, or a toggle group — with support for single or multi-select, dynamic data sources, and configurable layout.

The component ships as three builder presets that share the same underlying configuration: Checkbox Group (standard checkboxes or radio buttons), Radio Group (single-select radio style), and Toggle Group (toggle switches). All three presets use the same properties panel; the presets simply set different defaults for Type and Is Multi Select.

Use this component to:

To configure the Checkbox Group, select it on the canvas. The Edit Input Choice Set panel opens on the right. The sections below mirror the Content group in the Properties tab.

Before you build your choice set, tell the component where to get its options. You have several options depending on the source and nature of your data:

When using a Query or Variable data source, configure the Data Mappings section to tell the component how to map record fields to option labels and values.

The main text label displayed above the choice set. You can bind it to a Salesforce field, formula, or a static string.

The default selected option, expressed as a semicolon-separated string. Bind this to a variable or formula to pre-populate the selection. Use this for single-select; for multi-select, use Value Collection.

The default selected options as a list. Bind this to a collection variable when multi-select is on. Requires: Is Multi Select = on.

Help text displayed next to the label to guide users on the purpose of the choice set.

Controls how the label is positioned relative to the choice set.

Controls how the choices are rendered. The three builder presets correspond to the three type values.

Additional settings available when Type is Button or Toggle.

Arranges options vertically (stacked) or horizontally (side by side). Defaults to Vertical.

Layout settings available when Orientation is Horizontal.

Position of the checkbox, radio button, or toggle indicator relative to its label — Left (default) or Right. Requires: Type = Default or Toggle.

If enabled, users can select more than one option. When off, only one option can be selected at a time (radio-button behavior for the Default type).

If enabled, the user must select at least one option before submitting. Use with Message When Value Missing to show a clear error.

The validation error message displayed when the field is required but no option is selected. Requires: Required = on.

If enabled, the choices are displayed but cannot be changed by the user.

If enabled, the entire choice set is disabled and users cannot interact with it.

All components support conditional visibility — see Component Visibility.

This example creates a single-select checkbox group for Opportunity stages, bound to a picklist.

Result: Users select one stage, updating the variable for filtering.

Combine the Checkbox Group with the "Set Component Visibility" feature to show/hide other components dynamically based on user selections. This is useful for conditional UIs, such as revealing a Kanban board only when specific filters are selected.

Result: The Kanban appears only when the configured status (for example, Active) is selected — or, in multi-select, when the selection contains that value — hiding otherwise for a cleaner, context-aware interface.

Interactions define what happens when users interact with the Choice Set. Configure them from the Interactions tab of the Edit Choice Set panel.

Fires when the user changes their selection. Use this to update a variable, trigger a query refresh on another component, or navigate to a new screen.

The Checkbox Group exposes these output variables you can reference elsewhere on the page after the user interacts with it.

When a user changes their selection, these variables update with the current selection data.

Configure the Checkbox Group's appearance from the Style tab of the Edit Input Choice Set panel. Several option hooks vary by the Type chosen in the Properties tab (Default, Button, Toggle).