Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Adding a Radio Button control

Updated on April 5, 2022

In your application, radio button controls present a horizontal or vertical list of options, from which a user can select a single option.

You can specify the source of this list as one of the following:

  • List defined on a property
  • Clipboard page
  • Data page
  • Report Definition

When a radio button control is bound to a data page or report definition that accepts parameters and the parameter value uses a property reference, the radio button group automatically refreshes with new items whenever the property value changes. You can use this functionality to set up cascading radio button lists or any combination of controls — no additional configuration is required.

You can configure events and actions on the radio button control, include a No Selection option, and define styles in the Skin form — Components tab — Controls — Radio buttons, if desired.

Upgrading radio button controls

Pega Platform includes the radio button control, pxRadioButton. If a section contains a deprecated radio button or another control for which there is an improved alternative, a warning displays, along with an Update Controls button. Click Update Controls to automatically update deprecated controls in the section. Automatic update is not available for all controls; see Upgrading deprecated and outdated controls on Pega Community.

If you have a use case that requires a specific configuration of a standard control, such as radio button, you can make a copy of the control and save it using a new name. For example, if you use a Yes/No radio button frequently, you can save a copy of pxRadioButton as pxYesNoRadioButton. Configure pxYesNoRadioButton to display Yes/No radio buttons, and then use pxYesNoRadioButton wherever you'd like it. Do not modify the Control Modes and UI Element settings.

The UI Gallery landing page contains a working example of this element. To display the gallery, in Dev Studio, click ConfigureUser InterfaceGallery UI elements.

Adding a radio button control

  1. On the Design tab, from the Pickers list, drag Radio buttons onto the work area.

    If you are using a cell-based layout and you drag the control into a cell that is not empty, then the dropped control replaces the current contents of the cell.

  2. Click the View properties icon to display the Properties panel.
  3. On the Properties panel, define the radio button using the following tabs:

For more information, see Presenting radio buttons on Pega Community.

Copy, delete, duplicate, or move a radio button group

  • To move a radio button group, hold down the SHIFT key, select the radio button group in the layout and drag and drop it in the new location.

  • To cut, copy, or paste a radio button group in a layout, right-click the control to access a context-menu.



  • Radio Buttons control Properties General tab

    Click the View properties icon in the layout containing the radio button control ( pxRadioButtons ) to display the Properties panel, and then select the General tab to define the source of radio button values.

  • Radio Buttons control Properties Presentation tab

    Click the View properties icon in the layout containing the radio button control ( pxRadioButtons ) to display the Properties panel, and then select the Presentation tab to configure the display of the radio buttons.

  • Radio Button Properties - Behavior tab

    Click the View properties icon in the layout containing the radio button control ( pxRadioButtons ) to display the Properties panel, and then select the Behavior tab to configure events and actions on the selected control.

  • Creating an action set

    Define an action set to specify what a control does when a user event happens.

  • Control form - Actions tab

    Action sets determine the behavior of a control.

  • Available actions and conditions

    Choose an action from the list, see which options are available for the action and when you can use it. Learn which conditions you can apply.

  • Keystores

    A keystore is a file that contains keys and certificates that you use for encryption, authentication, and serving content over HTTPS. In Pega Platform, you create a keystore data instance that points to a keystore file.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us