Radio Group Widget

Places a group of radio buttons.

Remarks

Overview

The Radio Group Widget places a set of interactive radio buttons on the PDF, mapped from a Data Field with multiple mutually exclusive options. Use this to visually represent single-select fields or option lists in exported PDF documents, where only one selection is allowed.

Configuration

• Add a Radio Group Widget annotation to the 'Annotations' collection of a PDF Data Mapping behavior.
• Use the 'Fields' property to specify which Data Fields or Data Columns the radio buttons should represent.
• Each radio button is generated for a value or option present in the field's data.
• Configure 'Allow Edit' to control whether users can interact with the radio buttons in compatible PDF viewers.
• Set 'Print' to determine if the radio buttons appear in printed output.

Example Use Cases

• Represent a single-choice field (e.g., "Payment Method", "Gender") as a group of radio buttons on the PDF.
• Display extracted or user-selected options for review and confirmation.
• Allow end users to select or update a single option directly in the PDF.

Notes

• Radio buttons are generated for each value or option present in the field's data.
• Only one radio button in the group can be selected at a time.
• The appearance and interactivity of radio buttons may depend on the PDF viewer used.
• If the field contains no radio button data, no annotation will be generated.

Properties

Name	Type		Description
Annotation Type	String		The annotation type.
Fields	Data Field[]	►	The list of fields to generate annotations for. EditorField Annotation Editor ConverterAll Fields Converter Selects which Data Fields or Data Columns this annotation applies to. Add one or more fields to target specific data elements. If left empty, the annotation will apply to all single-instance fields in the Document Type. Use this to visually highlight, annotate, or add widgets to specific fields.
Padding	Logical Border	►	The amount of padding to include around each zone. ConverterLogical Border Converter Positive values increase the size of the annotation; negative values decrease it. Use to adjust the visual region of the annotation relative to the field's detected location. Useful for emphasizing or de-emphasizing the annotated area.
Allow Edit	Boolean	►	Specifies whether the annotation should be editable in PDF viewer applications. DefaultFalse When enabled, users can interact with or modify the annotation in compatible PDF viewers. Applies to interactive widgets and some visual annotations.
Print	Boolean	►	Specifies whether the annotation should be included when the PDF document is printed. DefaultFalse Enable to ensure the annotation appears in printed output. Disable to make the annotation visible only on-screen.

See Also

Data FieldLogical Border