Docs & Support

Learn about all the Formidable features and get support from our amazing customer success team.

frm_radio_display_format_options

Heads up! This article contains PHP code and is intended for developers. We offer this code as a courtesy, but don't provide support for code customizations or third-party development.

Use the frm_radio_display_format_options filter to change the options of the display format setting for a Radio Button field. For a Checkbox field, use frm_checkbox_display_format_options.

The Display format control in the form builder lists the options. By default, they are Simple, Images, and Buttons.

Usage

add_filter( 'frm_radio_display_format_options', 'my_function_name', 10, 2 );

Formidable Forms makes advanced site building simple. Launch forms, directories, dashboards, and custom WordPress apps faster than ever before.

Parameters

  • $options (array): The display format options. Each key is the saved value of the format. Each item is an array with a text label and an svg icon class. The Images and Buttons items also have an addon key (the add-on lock) and the upgrade, message, and content keys used by the upgrade prompt. The default keys are 0 (Simple), 1 (Images), and buttons (Buttons).
  • $field (array): The field settings.

Return the $options array.

Examples

Learn where to put the code when adding a custom PHP function to your site.

Add custom display format option

Use this code to add a custom display format option to the Radio field. The new option shows in the Display format control after Buttons.

add_filter( 'frm_radio_display_format_options', 'custom_radio_display_format_options' );
function custom_radio_display_format_options( $options ) {
	$options['custom-format'] = array(
		'text' => 'Custom format',
		'svg'  => 'frm_simple_radio',
	);

	return $options;
}

Remove the Buttons format from Checkbox fields

Use this code to hide the Buttons display format in Checkbox fields. Radio Button fields keep it.

add_filter( 'frm_checkbox_display_format_options', 'remove_checkbox_buttons_format' );
function remove_checkbox_buttons_format( $options ) {
	unset( $options['buttons'] );

	return $options;
}

Limitations

  • Formidable Pro 7.1 and newer removes the Surveys add-on lock from the Buttons option on its own. Pro does this with the same filter, at priority 20, by removing the addon key. To put the addon lock back, use a priority of 21 or more. Removing Buttons (Example 2) works at the default priority 10.
  • Product fields don't have the Buttons option. The frm_product_display_format_options filter doesn't list it.
Was this article helpful? *

This article may contain affiliate links. Once in a while, we earn commissions from those links. But we only recommend products we like, with or without commissions.

In this article

    We have a small, but amazing team of dedicated people who are committed to helping you achieve your goals and project requirements.


    Copyright © 2026 Strategy11, LLC. Formidable Forms® is a registered trademark Strategy11, LLC.

    Complete your purchase
    Don't forget your purchase!
    Complete Purchase
    Join 400,000+ using Formidable Forms to create form-focused solutions fast. Get Formidable Forms