Only available in the Enterprise plan
A split text field allows signers to enter information across multiple individual character boxes within a single field. Each box captures one character, making it ideal for collecting structured data where characters need to be separated.
This field is especially useful for inputs such as one-time passwords (OTPs), verification codes, identification numbers, license numbers, or other formatted entries. By splitting the input into separate character boxes, senders can ensure consistent formatting and reduce entry errors.
Example:
A bank sending a verification form may need customers to enter their bank account number to confirm their identity. Using a split text field ensures that each digit is entered separately and in the correct format, improving readability and accuracy.
How to configure a split text field
After uploading your document and continuing to the document viewer page,
- Drag and drop the Split text field onto the required section of the document.
- Click on the field and configure the basic settings in the pop-up (Default value, Field name, and Data label).
- Customize the layout of the split text boxes to suit your document design:
- Width: Adjusts the width of the character boxes.
- Height: Adjusts the height of the field.
- Character count: Defines the number of individual character boxes. You can enter up to 100 characters per field.
- Character spacing: Adjusts the spacing between each character box.
- Alternatively, adjust the width and height by dragging the corners of the field.
Data validation and custom formats for split text fields
You can enforce data validation rules for split text fields. When validation is enabled, signers must enter values that match the specified format. To avoid errors, define the correct format so the signer can provide valid input.
Use the following characters to define your format:
Symbol | Description |
| Uppercase letter (A–Z) |
w | Lowercase letter (a–z) |
L | Any letter (case-insensitive) |
d | Digit (0–9) |
* | Letter or number |
**@ # $ % ^ & * ( ) - _ + = \ : ' " . , / and space | Special characters |
To use d, L, W, w, *, -, or \ as predefined values, prefix the character with a backslash (\).
Generated formats help structure inputs with predefined patterns.
How to generate a format for a split text field
- Click on the field and click Generate format.
- Enter the sample text (the desired output you need from your signer) in the pop-up. The corresponding format will appear.
- Click Use format to apply it to the split text field.
- Enclose static content within curly braces { }.
Examples: - Employee ID
Format: WW-dddd
First two characters must be letters followed by four digits
Example input: HR-4821 - Product serial code
Format: ***-***
Allows letters or numbers in each segment - Example input: A1B-9K2
Custom formats allow you to enforce very specific input patterns.
- Examples:
License plate number
Input format: WW-dddd
Two uppercase letters followed by four digits
Example output can be: KA-2345
- Verification code with mixed characters
Input format: dWdWdW
Alternating digits and uppercase letters
Example output can be: 3A4B9C
Validation settings will automatically be disabled if a custom format or generated format is applied to the split text field.