Checkboxes

Checkboxes allow users to select one or more options from a set. Checkbox button groups let you quickly set a group of checkboxes for your users to choose from.

Use this option to give users multiple predefined options to select from.

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 Checkbox to an existing form:

  1. Open the Form Builder

    1. Click Create new form from the My Forms page
    2. Edit an existing Create form macro on a page

  2. Use the Add question button to add a Checkbox field.

  3. 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 checkbox options.

    4. (Optional) Click the + icon to add a field. Use the - option to remove one.

    5. (Optional) You can use the Selected option to predefine a selected checkbox option.

    6. (Optional) Select the Make this field required checkbox option.
      This will prevent users from submitting the form without adding an attachment in this field.

  4. Click Save in the Form builder when finished.
    This saves the inputs and returns the screen to Confluence Edit mode.
  5. Publish or Preview the page to see the final result.

Example use case

For a use case, let's edit an existing form to gather data for an upcoming company lunch. The checkbox option will be used so that users can select their favorite from a list of fruit options for an upcoming meal. 

  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 Checkbox option.

    The checkbox configuration options appear.

  4. Click Add a question.

    Type: What is your favorite fruit?

  5. Click Add a description.

    Type: Please select one or more of the provided options.

  6. Click the first checkbox option labeled Option.

    Type: Apple.

  7. Click the + option.

    A new checkbox option appears below the first.

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

  9. Repeat clicking the + option to add a checkbox option twice more. Label the checkbox options created as Kiwi and Pineapple.

  10. Ensure the Selected option remains on the first field, labeled Apple.

  11. Click Save.
    The field appears as a placeholder in Confluence Edit mode.

  12. Click Publish or Preview to see the result.

On this page