Title: Button Group Field
Published: February 20, 2025
Last modified: February 21, 2025

---

# Button Group Field

## In this article

 * [Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/?output_format=md#key-features)
 * [Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/?output_format=md#settings)

[ Back to top](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/?output_format=md#wp--skip-link--target)

The Button Group field provides a set of buttons where users can select one option
from multiple choices. It offers a more visual and user-friendly alternative to 
radio buttons or select dropdowns.

## 󠀁[Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/?output_format=md#key-features)󠁿

 * Visual button-style interface
 * Single option selection
 * Customizable button labels
 * Clear visual indication of selected option

## 󠀁[Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/?output_format=md#settings)󠁿

 * Choices – Define the available options
 * Default Value – Set the pre-selected option
 * Return Format – Specify how the value should be returned
 * Allow Null – Option to have no selection

First published

February 20, 2025

Last updated

February 21, 2025

Edit article

[ Improve it on GitHub: Button Group Field ](https://github.com/wordpress/secure-custom-fields/edit/trunk/docs/features/field/button-group/index.md)

Changelog

[ See list of changes: Button Group Field ](https://github.com/wordpress/secure-custom-fields/commits/trunk/docs/features/field/button-group/index.md)

[  Previous: ACF_Repeater_Table](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/class-acf-repeater-table-file/)

[  Next: Using the Button Group Field](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/button-group/button-group-tutorial/)