Published at: 2026-09-17
Number
Overview
The number field is a basic field type for storing numeric data. It is suitable for business scenarios that require precise numeric values, such as age, quantity, and dimensions. This field supports integer and decimal digit configuration, thousands separator display, and masking. It can also serve as an operand for formula and roll-up summary fields, making it a core data carrier for building financial, inventory, and production business models.
Basic specifications
| Attribute | Description |
|---|---|
| Applicable scenario | Age, order quantity |
| Maximum digits | Maximum digits = integer digits + decimal digits |
Configuration highlights
- Digit settings: Maximum digits = decimal digits + integer digits. Front-end input limits follow the back-end configuration.
- Show thousands separator: When set to “Yes”, numbers display with thousands separators in the front end (print output does not show separators).
- Mask display: When configured, users outside the specified roles see the field value as a mask (**).
- Default value: Select a number as the default value (integers up to 12 digits, decimals up to 2 digits), or enter a formula.
Default values and required settings
Default value
Number fields support the following default value methods:
- Fixed number: Enter a number as the default value. Integers are limited to 12 digits and decimals to 2 digits.
- Formula: Use a formula to dynamically calculate the default value. For example,
Quantity * Unit Priceauto-calculates when the user edits the quantity and unit price on the front end. The fields involved in the calculation must be existing number or amount type fields in the current object.
[!NOTE] The default value is auto-filled when creating a new record in the front end. Users can modify it after pre-filling. After modifying a default value formula, historical data is not recalculated.
Required configuration
- Field-level required: On the field configuration page, set “Required” to “Yes”. This applies across all scenarios (front-end entry and back-end import). Missing values prevent saving.
- Layout-level required: If the field is required only in specific business scenarios, set it as not required in the field properties. Then, in the specific page layout editor, check “Required”.
- Conditional required: If the required condition depends on the value of another field, configure validation rules.
Usage limitations
- Number fields can serve as operands for formula and roll-up summary field calculations.
- Handle null values carefully when using number fields in formulas.