Skip to main content

Conditional logic

Forms logic makes fields react to other fields on your form. There are three types: One of a group, Add to a total, and Conditional fields.

To access the logic settings for a field:

  1. Go to the template's Edit Fields page.
  2. Select a field to open the Field Properties panel.
  3. Click the Advanced tab.

The Advanced tab contains Link Field and Link Value — the two controls used to create logic connections between fields.

Field Properties panel showing the Advanced tab with Link Field and Link Value controls

One of a group​

One of a group creates a set of checkboxes where the signer can select only one — useful for mutually exclusive options.

tip

For exclusive-choice questions, a dropdown field is often a better signing experience than a group of checkboxes.

For each checkbox in the group:

  1. Select the checkbox field.
  2. Click the Advanced tab in Field Properties.
  3. Set Link Field to One of a group.
  4. Set Link Value to the same word for every checkbox in the group (any A-Z word).

Add to a total​

Add to a total sums the numerical values of several fields into a single total field. Useful for timesheets, expenses, or any form that requires a calculated sum.

For each field that contributes to the sum:

  1. Set the field to optional.
  2. Click the Advanced tab in Field Properties.
  3. Set Link Field to Add to total.
  4. Set Link Value to the same word across all contributing fields (a short A-Z word).

On the field where the total should appear:

  1. Enter that same word in the Ref Name input.

Conditional fields​

Conditional fields show or hide fields based on the value of another field (the controller field). A controller field can control one or more conditional fields.

Set conditional fields to optional

All conditional fields must be set to optional. If a conditional field is left as required and its condition is not met, the field will be hidden but the signing page will still demand a value — making the document impossible to complete.

Show fields when the value is YES or a checkbox is ticked​

  1. Add a Dropdown or Checkbox field (the controller field).
  2. If using a dropdown, create an option called YES. If using a checkbox, leave it as the default tick box.
  3. Assign the controller field a Ref Name.
  4. Add one or more conditional fields. For each conditional field:
    • Set Link Type to Make this conditional upon.
    • Set Link Value to the controller field's Ref Name.

Show fields for a specific dropdown value​

  1. Add a Dropdown field (the controller field).
  2. Create the required dropdown options.
  3. Assign the controller field a Ref Name.
  4. Add one or more conditional fields. For each conditional field:
    • Set Link Type to Make this conditional upon.
    • Set Link Value using the format: <Controller Ref Name>,<Dropdown Value>

Multiple conditional routes​

A single controller field can control multiple groups of fields. For example, a dropdown called Reason for Enquiry with options Complaint, Sales Enquiry, and Technical Support, and a Ref Name of Reason:

  • If Reason = Complaint — display the complaint details fields.
  • If Reason = Sales Enquiry — display the sales enquiry fields.
  • If Reason = Technical Support — display the technical support fields.

Each group of conditional fields references the same controller field with a different Link Value:

Reason,Complaint
Reason,Sales Enquiry
Reason,Technical Support

Different form sections appear depending on the option the signer selects.