documentation-logo
Menu
  • Guides
  • Form Creation
  • General fields

How does the radio button field work in IvyForms?

ON THIS PAGE

The Radio Button field in IvyForms lets users choose exactly one option from a list of predefined choices. It is ideal for questions where only a single answer is allowed, such as selecting a plan type, a yes or no response, or a preferred contact method. This article explains how the Radio Button field works and how you can customize its options and behavior in the form builder.

 

Front-end view of a Radio Button field in an IvyForms form showing multiple selectable options.

Front-end appearance

Where can I find the radio button field in IvyForms?

You can add the Radio Button field from the General fields section in the left panel of the IvyForms builder. When this section is expanded, you will see the Radio Button field listed together with other inputs. Click it to add it to your form, then select the field in the preview to open its configuration options.

 

IvyForms field list with the Radio Button field highlighted and other fields grayed out in the panel.

What settings can I configure for the radio button field?

After you add the Radio Button field and click it in the preview area, the sidebar switches to the Options view. Settings are organized into three sections: General, Advanced, and Smart logic. These control how the field looks, which options are available, and when the field is displayed.

 

How do general settings work for the radio button field?

 

The General tab contains the main configuration controls for the Radio Button field. Here you define the question label, manage the list of choices, and adjust how the options are presented to users on the front-end.

 

General options for the Radio Button field in IvyForms showing label, description, required, option list, show values, shuffle options, and CSS classes.
 

  • Label – sets the main question or title that appears above the radio options.
  • Hide label – removes the visible label while keeping the options on the form.
  • Description – adds a short line of helper text below the label to clarify what users should select.
  • Required – makes it mandatory to choose one of the available options before submitting the form.
  • Read-only – shows the selected option without allowing users to change it.
  • Placeholder – may be used by the theme or layout to provide additional contextual text where needed.
  • CSS classes – lets you attach custom class names so you can style the radio field through your own CSS rules.
  • Option list – allows you to add new choices, rename existing ones, or remove options that are no longer needed.
  • Show values – displays the stored values next to the visible labels, which can be useful when you need to distinguish between label text and underlying saved values.
  • Shuffle options – randomizes the order of the radio choices on each page load, which can help avoid bias toward the first options in the list.

 

How do advanced settings work for the radio button field?

 

The Advanced tab for the Radio Button field includes a single global setting called Label position. This setting controls where the main field label appears in relation to the group of radio options. You can keep the default placement or move the label to the top, left, or right to better align with the rest of your form design. All other behavior is configured in the General and Smart logic sections.

 

How can I use smart logic with the radio button field?

Smart Logic is available only in the Pro version of IvyForms.

 

The Smart logic section lets you show or hide the entire Radio Button field based on other inputs in the form. By default, smart logic is turned off, so the field is always visible. When you enable it, you can define rules that control when the field should appear.

 

Smart logic settings for the Radio Button field in IvyForms showing conditional match and rule configuration options.
 

Once smart logic is enabled, the Conditional match option becomes available and lets you choose how the rules should be interpreted:

  • Any – the Radio Button field is shown if at least one of the configured conditions is satisfied.
  • All – the Radio Button field is shown only when all defined conditions are met at the same time.

 

These conditions use values from other fields in the same form. For example, you can show a Radio Button group only after a user selects a specific category, chooses a country, or indicates that they want to provide additional preferences. This helps keep your forms focused, since users see follow up choices only when those choices are relevant to their previous answers.