Field reference
Multi select field
A token-based control for choosing more than one value.
#Field definition
Add this array inside a block, field group, or option page fields list.
['field_key' => 'audiences', 'label' => 'Audiences', 'type' => 'multi_select', 'options' => [['value' => 'agency', 'label' => 'Agency'], ['value' => 'startup', 'label' => 'Startup']]]#Saved value
| Property | Value |
|---|---|
| Field type | multi_select |
| PHP / REST value | string[] |
| Empty value | [] |
#Rendering example
Read block fields from $attributes. Post fields use voxycure_get_field(); option fields use voxycure_get_option().
$value = $attributes['audiences'] ?? '';
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. |