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).

Radio Group creation
Before jumping to the creation options, let’s review the main characteristics of a Radio Group :
Parameters | Descriptions |
---|---|
name | Radio group's name. Not displayed to the Signer. Used to connect different Radio Buttons in the same Radio Group. |
optional | Define if selecting a Radio Buton in the Radio Group is optional or not. Defaults to false and is optional. |
radios | Array 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_only | Define 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:
- Create a Signer and a Radio Group at the same time using this endpoint:
/POST /signature_requests/{signatureRequestId}/signers
- 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
.
Updated 18 days ago