Field reference

Gallery field

An ordered list of Media Library images.

#Field definition

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

PHP
['field_key' => 'gallery', 'label' => 'Gallery', 'type' => 'gallery']

#Saved value

PropertyValue
Field typegallery
PHP / REST valueobject[]
Empty value[]

#Rendering example

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

PHP
foreach ((array) ($attributes['gallery'] ?? []) as $image) {
    echo wp_get_attachment_image((int) $image['id'], 'large');
}

#Common field options

KeyTypePurpose
field_keystringRequired unique storage key using lowercase letters, numbers, underscores, or hyphens.
labelstringHuman-readable editor label.
default_valuemixedValue used before content is saved. Match the field value type.
requiredbooleanRejects an empty option-page submission.
conditional_logicarrayControls editor visibility based on another field.
locationstringdefault or inspector for block fields.
Framework version2.0.0
PHP requirement8.0+
Documentation updatedAugust 2026