Text field (single line text)

Overview

The Text field is a form field type that allows users to input a single line of data (letters, numbers, or special characters) onto the form.

How to add and configure a text field

In the Legacy Form Builder, select the Text field from the Add Fields menu on the left to add it to your form.
Select the pencil icon next to the name of the field on the form to change its name. This will be the prompt that users will see on the form in the app (e.g., Enter your name).
Optional: Use the Text Settings menu on the right to configure the character length, character format, hint text, and more. The following table describes related terms and options:

Configuration

Setting	Description
Field Label	The label displayed for the field. This is usually displayed at the top left corner above the field.
Field Key	A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations.
Default Value	The value that will be used to pre-populate the field when the form is initially opened.
Hint Text	The text that is displayed if the field has no value set, e.g. "Please enter a value"
Enforce Min/Max	If set, this enforces the Min Length and Max Length settings.
Minimum Length	The minimum required length of characters required for a valid value.
Maximum Length	The maximum number of characters allow for entry into the field.
Memory Field	If a previous form containing the same Field Key has a value set, its value will be pre-populated for this field when the form is first opened.
Rules	A Rule or JavaScript snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, showSection, and hideSection. Rules are executed on field value changes and when the form is opened. ex. `if ($field1$ > 23) { hide(); } else { show(); }` (Please see the Introduction to Rules Document for more information)
Required	Sets the field to have required input. You will not be able to submit the form until this field has valid input.
Enabled	If not set, the field will be visible but cannot be edited or set to accept new input.
Hide Field Label	Hides the Field Label.
Hidden	If enabled, the field and all labels are not visible.
Exclude From Reports	If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports.
Capture Geo Location	Capture the current latitude and longitude when the acknowledgment button is clicked.
Capture Time Stamp	Capture the current date and time when the acknowledgment button is clicked.
Alert Type	Choose a theme to change the background and font colors of the field cell as displayed in the apps.
Secure	If set, the input is masked from view with an * character.

Result Data

Data Type	Domain of Values	Example JSON
String	N/A	{ "singlelinealpha_1": "hello" }