Field reference

Image field

A Media Library selection stored as an object containing an attachment ID and URL.

#Field definition

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

PHP
['field_key' => 'portrait', 'label' => 'Portrait', 'type' => 'image']

#Saved value

PropertyValue
Field typeimage
PHP / REST valueobject
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().

PHP
$image = $attributes['portrait'] ?? [];
echo wp_get_attachment_image((int) ($image['id'] ?? 0), '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