All Field Types Reference

Complete reference for every field type — PHP output format, available settings, and configuration notes.

Text

Single-line plain text input.

PHP Output

$fields['field_key'] // string

Settings

  • Label
  • Field key
  • Default value
  • Placeholder
  • Max length
  • Required
  • Help text

Textarea

Multi-line plain text area.

PHP Output

$fields['field_key'] // string with newlines

Settings

  • Label
  • Field key
  • Default value
  • Placeholder
  • Rows
  • Required
  • Help text

Rich Text (WYSIWYG)

Full WordPress editor with formatting controls.

PHP Output

$fields['field_key'] // HTML string, use wp_kses_post()

Settings

  • Label
  • Field key
  • Toolbar (basic/full)
  • Media enabled
  • Required

Number

Numeric input with optional min/max/step.

PHP Output

$fields['field_key'] // int or float

Settings

  • Label
  • Field key
  • Min
  • Max
  • Step
  • Default
  • Required

URL

URL input with format validation.

PHP Output

$fields['field_key'] // string — use esc_url()

Settings

  • Label
  • Field key
  • Default
  • Placeholder
  • Required

Email

Email address input with format validation.

PHP Output

$fields['field_key'] // string — use sanitize_email()

Settings

  • Label
  • Field key
  • Default
  • Required

Image

Select or upload a single image from the Media Library.

PHP Output

$fields['field_key'] // array: { id, url, alt, width, height, sizes }

Settings

  • Label
  • Field key
  • Preview size
  • Return format (array/url/id)
  • Required

File Upload

Upload any file type and return attachment data.

PHP Output

$fields['field_key'] // array: { id, url, filename, filesize, mime_type }

Settings

  • Label
  • Field key
  • Allowed file types
  • Return format
  • Required

oEmbed

Embed video, audio, or any oEmbed-supported URL.

PHP Output

$fields['field_key'] // embed HTML string

Settings

  • Label
  • Field key
  • Required

Select

Dropdown with configured choices.

PHP Output

$fields['field_key'] // string (value of selected option)

Settings

  • Label
  • Field key
  • Choices (label:value pairs)
  • Default
  • Allow null
  • Multiple
  • Required

Radio

Single-choice radio buttons.

PHP Output

$fields['field_key'] // string (value of selected option)

Settings

  • Label
  • Field key
  • Choices
  • Default
  • Required

Checkbox

Multiple-choice checkboxes.

PHP Output

$fields['field_key'] // array of selected values

Settings

  • Label
  • Field key
  • Choices
  • Default
  • Layout (vertical/horizontal)
  • Required

Toggle / Switch

Boolean on/off toggle.

PHP Output

$fields['field_key'] // bool

Settings

  • Label
  • Field key
  • Default (true/false)
  • On label
  • Off label

Repeater

Unlimited rows of structured sub-fields.

PHP Output

$fields['field_key'] // array of row arrays

Settings

  • Label
  • Field key
  • Sub-fields
  • Min rows
  • Max rows
  • Collapsed by default
  • Add row label

Inner Blocks

Container for nested Gutenberg blocks.

PHP Output

$fields['field_key'] // rendered HTML string

Settings

  • Label
  • Field key
  • Allowed blocks
  • Template (default blocks)
  • Template lock

Color Picker

RGB/HEX/HSL colour selector with optional opacity.

PHP Output

$fields['field_key'] // string hex or rgba

Settings

  • Label
  • Field key
  • Enable opacity
  • Default
  • Required

Range Slider

Numeric slider with min/max/step.

PHP Output

$fields['field_key'] // int or float

Settings

  • Label
  • Field key
  • Min
  • Max
  • Step
  • Default
  • Append unit string
← Field Types OverviewTemplates Overview →