Radio Buttons

Radio buttons should be used when you want your users to select a single option from a group. Radio Buttons lets you quickly set up a group of buttons for your users to choose from.

Radio button groups are always required, as using the field assumes you want at least one option to be picked. If you're going to allow users not to select an option, you should use Checkboxes instead.


Before adding Radio Buttons, or any other question, the Forms for Confluence container must be added to the page.

Visit the Creating Forms page for detailed instructions on adding a form to a page.

How to add Radio Buttons to an existing form:

  1. Navigate to the page with the relevant form and enter Edit mode.

  2. Click the existing Form, then click Edit.

    The form configuration appears.
  3. Use the Add question button to add the Radio buttons option.

    The checkbox configuration options appear.
  4. Fill in desired configuration details.

    1. Provide a title or question.
    2. Provide a Label for each Option.
    3. (Optional) Add a description to appear under the radio button options.
    4. (Optional) Click the icon to add an option. Use the button to remove one.
    5. (Optional) Use the Selected option to predefine a selected radio button option.
  5. Click Save in the Form builder when finished.
    This saves the inputs and returns the screen to Confluence Edit mode.
  6. Publish or Preview the page to see the final result.

Example use case:

Add the Radio Buttons option to as form to gather data for an upcoming company lunch.

Before adding Radio Buttons, or any other question, the Forms for Confluence container must be added to the page.

Visit the Creating Forms page for detailed instructions on adding a form to a page.

  1. Navigate to the page with the relevant form and enter Edit mode.

  2. Click the existing Form, then click Edit.
    The form configuration appears.
  3. Use the Add question button to add the Radio buttons option.
    The configuration options appear.

  4. Click Add a question.

    Type: Where should we hold the company lunch?

  5. Click Add a description.

    Type: Help us decide where to host the meal!
  6. Click the first radio button option, labeled Option.

    Type: Newton Park
  7. Click the option.

    A new radio button option appears below the first.

  8. Click inside the Text field of the next option.
    Type: Office Commonspace.

  9. Repeat clicking the option once more. Label the new option: Coffee Cafe.
  10. Click the Selected radio button option next to the field labeled Office Commonspace.
  11. Click Save.
    The field appears as a placeholder in the Confluence Edit mode.
  12. Click Publish or Preview to see the result.

On this page