Field reference

Checkbox field

A single checkbox stores a boolean. Supplying options turns it into a multiple-choice checkbox group.

#Field definition

Add this array inside a block, field group, or option page fields list.

['field_key' => 'features', 'label' => 'Features', 'type' => 'checkbox', 'options' => [['value' => 'fast', 'label' => 'Fast'], ['value' => 'secure', 'label' => 'Secure']]]

#Saved value

Property	Value
Field type	`checkbox`
PHP / REST value	`boolean or string[]`
Empty value	`""` or the configured default

#Rendering example

Read block fields from $attributes. Post fields use voxycure_get_field(); option fields use voxycure_get_option().

$value = $attributes['features'] ?? '';
echo esc_html(is_array($value) ? implode(', ', $value) : (string) $value);

#Common field options

Key	Type	Purpose
`field_key`	string	Required unique storage key using lowercase letters, numbers, underscores, or hyphens.
`label`	string	Human-readable editor label.
`default_value`	mixed	Value used before content is saved. Match the field value type.
`required`	boolean	Rejects an empty option-page submission.
`conditional_logic`	array	Controls editor visibility based on another field.
`location`	string	`default` or `inspector` for block fields.