Radio Group

What is a Radio Group?

A Radio Group allows you to create a multiple-choice selection within a Document. The Signer must select **one option from a predefined set of Radio Buttons. A Radio Group must contain between 2 and 20 Radio Buttons.

Unlike Checkboxes, which allows multiple selections, Radio Groups enforce a single Radio Button selection, making them useful for questions that require exclusive choices (e.g., Yes/No).

image.png

Radio Group creation

Before jumping to the creation options, let’s review the main characteristics of a Radio Group :

ParametersDescriptions
nameRadio group's name. Not displayed to the Signer. Used to connect different Radio Buttons in the same Radio Group.
optionalDefine if selecting a Radio Buton in the Radio Group is optional or not.
Defaults to false and is optional.
radiosArray of Radio Buttons, each defined by:
• An optional name, used to retrieve a Radio Button value, not displayed to the Signer.
• The position coordinates.
• The Radio Button size in pixels.
• An optional default_checked to check the Radio Button value by default.

This array must contain between 2 and 20 Radio Buttons.
read_onlyDefine if the value of the Field can be edited by the Signer. It can only be set to true if one of the radios has default_checked to true. Defaults to false and is optional.

Radio Group creation with Smart Anchors

Smart Anchors allow you to insert a Radio Button within your document using this pattern:

  • Pattern: {{signer_index|radio|size|group_name|optional|radio_button_name}}
  • Example: {{s1|radio|28|group_name_1|t|my_radio_button_name_yes_answer}} & {{s1|radio|28|group_name_1|t|my_radio_button_name_no_answer}}

The group_name parameter is connecting different Radio Button in the same Radio Group.

The Signers index (s1, s2, s3, etc) is determined by the Signers order in the Signature Request. If the index references a non-existent Signer, the Field won’t be created.

Radio Group creation with API endpoints

To create a Radio Group using the API endpoints, you have two options:

  1. Create a Signer and a Radio Group at the same time using this endpoint:/POST /signature_requests/{signatureRequestId}/signers
  2. Add a Radio Group to an existing Signer using this endpoint:/POST /fields/{signatureRequestId}/documents/{documentId}/fields

Retrieve Radio Group value once filled by the Signer

To retrieve the Signer input, you will need to:

  • Fetch the Radio Group Field thanks to its name using this endpoint:/GET /signature_requests/{signatureRequestId}/documents/{documentId}/fields&signer_id[eq]=500800fc-3f91-4e86-a9c9-866809a1e3c9s&type[eq]=radio_group&name[eq]=RadioGroup1.