Radio Button


The Radio button field creates a list of select-able inputs.



  • Return Format setting added in version 5.4.0
  • Allow Null setting added in version 5.3.8
  • Other & Save Other settings added in version 4.1.7


Name Description
Choices Each choice is entered on a new line (eg. ‘Red’). For more control over the value and label, you may use a ‘ : ‘ character to specify both (eg. ‘red : Red’)
Allow Null By default it is not possible to ‘un-select’ an input. This setting allows you to do so using JS
Other Adds a text input allowing for a custom value to be entered
Save Other Allows the custom value to be appended to the field’s choices
Default Value Specify the default value selected when first editing the field’s value. Enter only value (not label)
Layout Changes the layout style of inputs from Vertical to Horizontal
Return Format Change the value format returned by the get_field() and similar functions.

Template usage


This example shows how to load and display a single selected value.

<p>Color: <?php the_field('color'); ?></p>

Display value and label

This example shows how to load a selected value and label without using the ‘Format value’ setting.


// vars
$field = get_field_object('color');
$value = $field['value'];
$label = $field['choices'][ $value ];

<p>Color: <span class="color-<?php echo $value; ?>"><?php echo $label; ?></span></p>

Format value setting

This example shows how to load a selected value and label using the ‘Format value’ setting (set to ‘Both’).


// vars
$color = get_field('color');

<p>Color: <span class="color-<?php echo $color['value']; ?>"><?php echo $color['label']; ?></span></p>


This example shows how to use a selected value to conditionally perform a task.

<?php if( get_field('color') == 'red' ): ?>
	<p>Selected the Red choice!</p>
<?php endif; ?>

Query posts

This example shows how to query posts that have the value ‘red’ selected.


$posts = get_posts(array(
    'meta_query' => array(
            'key' => 'color', // name of custom field
            'value' => 'red',

if( $posts ) {