Overview
Use the Numeric field to capture single-line numeric data. This field supports positive and negative numbers, and you can customize the following parameters to ensure accurate input:
Number of decimal places
Minimum value
Maximum value
You also have the option to include a prefix (e.g., $, €) or suffix (e.g., %, kg), along with a security setting that hides the entered value in the app.
Note
Alphabetic (e.g., five) and alphanumeric (e.g., 7LBZ281) characters are not supported.
How to add a numeric field
Select the Numeric field in the Legacy Form Builder in the Add Fields menu on the left.
Rename the field on your form to your desired prompt (e.g., Quantity).
Optional: Customize any settings in the Numeric Settings menu on the right (see below for more details).
Numeric settings
Decimals
Set the number of allowed decimal places into the numerical input
Min. / Max. Value
This will force the user to input a value within the range of the predetermined data set.
Prefix
Set text or characters that will precede the numerical value. This will only be shown in the final reports.
Suffix
Set text or characters that will precede the numerical value. This will only be shown in the final reports.
Secure
This will hide the entered value in the app while being input.
Optional Setting
There is an optional setting within the numeric field. You can toggle between keyboard and counter inputs in the field settings menu in the portal.
Additional 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. |
Hint Text | The text that is displayed if the field has no value set (e.g., "Please enter a value"). |
Default Value | The value that will be used to pre-populate the field when the form is initially opened. |
Decimal Positions | The number of decimal position to show in the value. |
Enforce Min./Max. | Requires user to enter a value within your Min./Max. Value settings. |
Minimum Value | The minimum allowed value for input. |
Maximum Value | The maximum allowed value for input. |
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, show section, and hide section. Rules are executed on field value changes and when the form is opened. |
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 checked, the input is masked from view with a * character. |
Result Data
Data Type | Domain of Values | Example JSON |
|---|---|---|
Numeric (Integer or Double based on Field Definition) | Any Numeric Value | { "singlelinenumeric_1": 5.5 } |
Note
9,223,372,036,854,775,807 is the maximum value for a 64-bit signed integer in computing.