Skip to main content

Sertifi Support Site

Advanced Data Field Parameters

Once you feel comfortable with the basics of Data Fields, you can start to use additional field parameters to create text boxes, check boxes, or radio buttons to add to your documents. You can also add the parameters to specify the field size, appearance, and options for each data field.

Field Creation Format

The base format for field creation is:

[[SFLD:FieldName:parameter1=value,parameter2=value]]

The parameter fields correspond to the following:

  • SFLD - the required prefix of the data field.

  • FieldName - the name you want to assign to the data field.

  • Parameter (optionall) - Refer to the following table for parameter types, descriptions, and values

Note

  • Note that each parameter must be separated by a comma.

Parameter Reference Table

Parameter

Description

Available Values

T

Field Type

Choose from the following values:

  • T for a textbox

  • C for a checkbox.

  • R for a radio button.

The default value for this property is T.

O

Option name for checkboxes

Use Yes or True to automatically check the box. If you use any other value here, the box remains unchecked until a signer selects it during signing. For example, O=Yes

O

Option name for radio buttons

Use any value for this property, depending on how you want to label a particular radio button. For example, O=Chicago

E

Export value for checkboxes

Use any value for this property depending on how you want to label a particular checkbox. For example, E=Pay Later.

H

The height of the data field, in pixels

Use any whole number values greater than 0. For example, H=12

W

The width of the data field, in pixels.

Use any whole number values greater than 0. For example W=10.

M

The maximum number of characters for a field.

Use any whole numbers greater than 0. For example, if you want to limit a signer's to only entering 10 characters for a textbox field, enter M=10.

Mi

The minimum number of characters for a field.

Use any whole numbers great than 0. For example, if you want to ensure that a signer enters at least four digits for an expiration date, enter Mi=4.

R

Designate a field as required (or not)

Use Yes or True to make a field required. For example, R=Yes.

S

Designate a field as secured

Use Yes or True to make a field secure. If you make a field secure, whatever information is entered into the field will be masked on a signed document. For example, S=True.

SL

Designates a level for the signer.

Use whole numbers 1–10 to select a signer level. For example, SL=2 for a second level signer.

SO

Determines the signer order.

Use whole number 1–16 to determine the signer order. For example, SO=3 to designate someone as the third person to sign.

ML

Wraps text added to text fields.

Use True to wrap text added to text fields by a signer on multiple lines. For example, ML=True.

RS

Automatically applies a field name to a field.

Use True to create unique field names for all fields. For example, RS=True.

VD

Date format validation.

Enter the date format that your signers will use in a text field. Available formats are:

  • MM/DD/YYYY

  • MM/DD/YY

  • M/D/YYYY

  • M/D/YY

  • YYYY-MM-DD

  • YY-MM-DD

  • YYYY-M-D

  • YY-M-D

V

Creates a field validation.

Enter the following values to collect information. Choose from:

  • Z – Zip code or Zip Code +4

  • P – phone number

  • S – Social Security number

  • St – State with two letter abbreviation (TX, IL, NY, CA, etc)

Textbox Field Templates & Best Practices

Refer to the following list for templates of common textbox field configurations.

  • [[SFLD:FieldName]] - a standard textbox

  • [[SFLD:FieldName:M=10]] - a textbox with a 10 character limit

  • [[SFLD:FieldName:W=100,H=15]] - a textbox with a custom size

  • [[SFLD:FieldName:W=300,H=15,R=True]] - a required textbox with a custom size

  • [[SFLD:FieldName:SL=2,W=100,H=15]] - a textbox that creates a signer at the second level

  • [[SFLD:FieldName:SL=1,SO=2,W=100,H=15]] - a textbot that creates a second signer at the first level

Textbot Field Best Practices

Use the following best practices when adding Textbox fields to your documents:

  • Use size parameters; the standard textbox field without specified size parameters tends to be too small for most cases.

  • Use descriptive names for your fields; the field name is used in the document database output and can be difficult to recognize without a descriptive or unique name.

  • Use a small font size (as small as 1 pt) when entering text in textbox fields to help maintain document formatting. This doesn't affect the size of the field itself when sent to the signer.

  • Use white font for fields so they don't appear when the document is used outside of Sertifi.

Checkbox Fields and Best Practices

Refer to the following list for templates of common checkbox field configurations.

  • [[SFLD:FieldName:T=C]] - a pre-checked standard checkbox

  • [[SFLD:FieldName:T=C,O=yes]] - a filled-in checkbox

  • [[SFLD:FieldName:T=C,O=no]] - a null checkbox, or a checkbox that is left blank by default

  • [[SFLD:FieldName:T=C,O=no,R=yes]] - a required checkbox

  • [[SFLD:FieldName:T=C,O=No,E=True]] - a custom output checkbox

  • [[SFLD:FieldName:T=C,O=Credit Card,W=9,H=9]] - a custom size checkbox

Checkbox best practices

Use the following best practices when adding checkbox fields to your documents:

  • Remember that the standard checkbox (without the O= parameter) will appear as selected by default.

  • Remember that if the O= parameter to anything other than Yes or True, it will appear empty.

  • Use descriptive names for your export value. The export value is used in the document database output and can be difficult to recognize without a descriptive or unique name.

  • Use size parameters of W=9,H=9 to hide the box outline on the signing page.

  • Use a small font size (as small as 1 pt) when entering text in textbox fields to help maintain document formatting. This doesn't affect the size of the field itself when sent to the signer.

  • Use white font for fields so they don't appear when the document is used outside of Sertifi.

Radio Button Templates and Best Practices

Refer to the following list for templates of common radio button configurations.

  • Default Radio Buttons - fields must share the same name to enable the selection of only one radio button in a group. In the following example, the field is named Test.

    • Option 1 [[SFLD:Test:T=R,O=Opt1]]

    • Option 2 [[SFLD:Test:T=R,O=Opt2]]

    • Option 3 [[SFLD:Test:T=R,O=Opt3]]

  • Required Selection Radio Button

    • Coffee [[SFLD:Drink:T=R,R=Yes,O=Coffee]]

    • Tea [[SFLD:Drink:T=R,R=Yes,O=Tea]]

  • Custom Size Radio Button

    • Coffee [[SFLD:Drink:T=R,R=Yes,O=Coffee,W=9,H=9]]

    • Tea [[SFLD:Drink:T=R,R=Yes,O=Tea,W=9,H=9]]

Best Practices

Use the following best practices when adding radio button fields to your documents:

  • Remember that the option value appears as the field value in the document database when the button gets selected.

  • Use size parameters of W=9,H=9 to hide the button outline on the signing page.

  • Use a small font size (as small as 1 pt) when entering text in textbox fields to help maintain document formatting. This doesn't affect the size of the field itself when sent to the signer.

  • Use white font for fields so they don't appear when the document is used outside of Sertifi.