Skip to main content
Version: Divi 5

Checkboxes

Purpose​

The Checkbox field type renders one or more checkboxes. Options can be defined manually or auto-detected (e.g. ACF). You can show images per option, use inline/grid layout, and style as buttons.

When to use​

  • Multiple selections from a list (e.g. interests, categories, terms).
  • Single checkbox for “I agree” or yes/no when Only Selected is used as needed.

Key settings​

  • Field — Field Type: checkbox, Field Title.
  • Checkbox — Checkbox Options (label/value/checked), Auto Detect, Exclude Options, Checkbox Only Selected.
  • Choice field layout — Inline, full width, gap, grid columns, field style (default/button).
  • Radio / Checkbox image — Show images, image IDs, label position, max width, same height.
  • Validation — Required (for at least one checked, if applicable).
  • Entries — View in entries, single checkbox value for one-checkbox fields.

Top features to configure​

  • Field style (default vs button) — Use default for simple forms, button style for clear visual toggles.
  • Inline vs grid layout — Use inline for short option sets, grid columns for larger sets.
  • Checkbox only selected — Useful when you only want chosen values saved or displayed.
  • Auto-detect + exclude options — Great for dynamic lists while still removing irrelevant choices.
  • Image choices — Add images to each option for visual selection workflows.

Validation behavior​

  • Required enforces at least one selection.
  • Single-checkbox use cases (agreement) should be tested to confirm expected saved value.
  • Auto-detected options should be reviewed whenever source content changes.

Common mistakes​

  • Using checkbox when only one choice should be allowed (use Radio buttons instead).
  • Not setting clear labels for agreement-style checkboxes.
  • Applying image/button styles without testing spacing across devices.

Verify it works​

  1. Submit with no selection when Required is on and confirm validation appears.
  2. Submit with one and multiple selections and verify saved values.
  3. Confirm image/button styles remain readable on mobile and desktop.

What's Next​

  • Use Radio buttons for single-choice alternatives.
  • Review Multistep form if this field is used in step-based forms.
  • Visit FAQ for option-display and validation troubleshooting.