Radio Matrix

The Radio Matrix lets you quickly set up a table format of radio buttons for multiple questions from which the user can select one answer per row. 

This type of option is commonly used in a rating or likes scale.

Field types must be added using the Form Builder to function.

Learn how to do this on our Create Your First Form page.

How to add a Radio Matrix macro 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 Builder appears.

  3. Use the Add question button to add the Radio matrix option.
    The configuration options appear.

  4. Fill in desired configuration details.

    1. Provide a title or question.
    2. (Optional) Provide a description to appear underneath the matrix.
    3. Define Row options by clicking in the associated text field(s).
    4. Define Column options by clicking in the associated text field(s).
    5. Use the + icon to add row options. Use the - button to remove unwanted options.
    6. (Optional) Use the Selected radio button option to preselect a column 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 Matrix option to a form to gather data for an upcoming company lunch. We'll ask the users to give predefined feedback on a list of drink options. 

  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 matrix option.
    The configuration options appear.

  4. Click Add a question.
    Type: What is your preference for the following drink options?

  5. Click the first Column label option, labeled Column option.

    Type: Dislike.

  6. Click the + option.


    A new Column label option appears below the first.

  7. Click inside the Text field of the next option.

    Type: Neutral.
  8. Repeat clicking the + button to add one last column option.
  9. Label the Text field: Preferred.
  10. Click the Select checkbox option next to Dislike. This deselects the default option.
  11. Click the Select checkbox option next to Neutral.

  12. Click the first Row label option, labeled Row option.

    Type: Iced Tea.
  13. Repeat clicking the + option to add a checkbox option three times more. Label the row options created as Cola, Sparkling Water, and Cranberry Juice.
  14. Click Save.
    The field appears as a placeholder in Confluence Edit mode.

  15. Click Publish or Preview to see the result.

On this page