This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.1)


represents a checkbox bar with setting x and with checkboxes for values to include in the list x.
CheckboxBar[Dynamic[x], {val1, val2, ...}]
takes the setting to be the dynamically updated current value of x, with the values in the list x being reset every time a checkbox is clicked.
represents a checkbox bar in which the checkbox associated with value has label .
  • Multiple checkboxes in a CheckboxBar can be checked at the same time. The values associated with all checked checkboxes are given in a list. »
  • The and can be strings, boxes, graphics, or any other expressions, including dynamic expressions. »
  • In CheckboxBar, Delimiter can appear as an element of list, specifying a vertical delimiter in the displayed setter bar.
  • The following options can be given:
AppearanceAutomaticthe overall appearance of the checkbox bar
BackgroundAutomaticbackground color to use
BaselinePositionAutomaticalignment relative to surrounding text
BaseStyle{}base style specifications for each checkbox bar
EnabledAutomaticwhether the checkbox bar is enabled, or grayed out
ImageMargins0margins around the displayed checkbox bar
  • Possible settings for the Appearance option include:
"Horizontal"equally spaced horizontally
"Vertical"equally spaced vertically
"Row"laid out like text, allowing linewrapping
  • The settings for BaseStyle and LabelStyle are appended to the default styles typically given by the and styles in the current stylesheet.
Create checkboxes with specified states:
Include labels:
Create checkboxes with specified states:
Click for copyable input
Include labels:
Click for copyable input
Use a dynamically updated setting:
Use any expression as a value:
Separate choices with a Delimiter:
Alter the size:
Alter the orientation:
Using the setting will allow the row of checkboxes to linebreak:
Change the background dynamically:
Align the labels with surrounding text:
By default, CheckboxBar is enabled:
By setting Enabled->False, the checkbox bar is disabled but visible in its current state:
CheckboxBar is a special case of TogglerBar:
CheckboxBar is built using Checkbox and can be used to track a list of values:
Values are added in the order clicked rather than in the order given by the list of possible values:
New in 6 | Last modified in 7