Docs/Developer Guide/Available Field Types

Available Field Types

What each type saves is what you get back from the read helpers — know the shape before you template against it. A terse version of this table lives in Reference → Field Types.

Type	Stored value	Notes
`text` `textarea` `url` `number`	string	Plain scalar.
`colorpicker`	"#rrggbb"	Hex string.
`select`	string key	Options are an assoc `[value => label]`.
`tabs` `radio_buttonset`	string key	Choices stored under `choices`.
`switch`	'on'/'off' or bool	Real PHP `bool` when `data_type => 'boolean'`.
`checkbox` `multicheck`	[key => '1']	Only checked keys present.
`datepicker`	date string	—
`image`	ID · URL · {id,url,alt}	Depends on `return_format`.
`gallery`	CSV / array of IDs	Read with the gallery helper.
`repeater`	array of row objects	Decoded automatically on read.
`post_select`	ID or slug	Per `save_format`; uses Select2.
`color_gradient`	{stops, angle, type…}	Nested array.
`multicolor`	[key => '#color']	Named color slots.
`typography` `spacing` `dimension`	assoc array	Composite values.
`editor`	HTML string	Output with `wp_kses_post`.
`radio_image` `group` `section_heading`	key / inline / none	Layout & choice helpers.

How the fields look

A close-up of the field types editors reach for most, exactly as they render in the builder.

Pure Metafields admin screen: colorpicker — **Colorpicker.** The WordPress color picker with a hex input.

Pure Metafields admin screen: image — **Image.** Pick from the Media Library or theme folder, with a thumbnail preview.

Pure Metafields admin screen: gallery — **Gallery.** Multiple images, reorderable, each one removable.

Pure Metafields admin screen: datepicker — **Date picker.** An inline calendar; stores a date string.

Pure Metafields admin screen: editor — **Rich editor.** The full TinyMCE editor (Visual / Code), stored as HTML.

Pure Metafields admin screen: dimension — **Dimension.** A number plus unit, with a range slider.

Pure Metafields admin screen: multicolor — **Multi color.** Named color slots, each stored by key.