Field reference
Repeater field
A repeatable list of rows with a defined child-field schema.
#Field definition
Add this array inside a block, field group, or option page fields list.
['field_key' => 'stats', 'label' => 'Statistics', 'type' => 'repeater', 'fields' => [['field_key' => 'value', 'label' => 'Value', 'type' => 'text'], ['field_key' => 'label', 'label' => 'Label', 'type' => 'text']]]#Saved value
| Property | Value |
|---|---|
| Field type | repeater |
| PHP / REST value | object[] |
| Empty value | [] |
#Rendering example
Read block fields from $attributes. Post fields use voxycure_get_field(); option fields use voxycure_get_option().
foreach ((array) ($attributes['stats'] ?? []) as $row) {
printf('<strong>%s</strong><span>%s</span>', esc_html($row['value'] ?? ''), esc_html($row['label'] ?? ''));
}#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. |