Number input

This article explains the features of the Number Input block and how it can be used to design your app.

Use Cases

1. Capturing Quantities: Record quantities for inventory items, materials, or products.
2. Collecting Measurements: Input measurements such as length, weight, or height.
3. Numeric Responses: Gather numeric responses like ratings or scores within a specific range.\

Help Video

Editing the Block

Click on the Number Input block and start editing on the panel that appears on the right side.

Label

The label is the name of the block that the end user sees in the app.

Example: Quantity, Score, Measurement, etc.

Description

The description is the additional information provided to the end user, displayed below the input area. You can also leave this blank if not necessary.

Example: Enter the quantity required.

Minimum Value

Set the minimum number that users can input in this field.

Example: If you set the minimum value to 5, users cannot enter a number below 5.

Maximum Value

Set the maximum number that users can input in this field.

Example: If you set the maximum value to 100, users cannot enter a number above 100.

Default Value

Specify a default number to display in the field when the app loads.

Example: If set to 5, the field will initially display "5" until the user changes it.

Required

Enable this option if you want to make this field mandatory. When enabled, users must enter a value in this field before submitting the form or else they will not be able to submit.

Advanced Options

Display this field if

Use this option to show or hide the field under specific conditions. It accepts the standard Clappia formulae, similar to conditional sections or in the ‘Calculations & Logic’ block.

1. Type @ to get a list of all the fields you have added in the app and select the relevant field or type @ followed by the field name.

2. Use these field variables to write spreadsheet-like formulae for conditional display of the field in the app.

Retain value if hidden

This option appears once a condition is set in the Display this field if option. Enable this setting if you want the field's value to be retained even when the field is hidden. This is useful for preserving user input in cases where the field may temporarily disappear based on conditions.

Example: If the field is hidden based on user selection but you still need to keep the entered value for future reference or calculations, enable this option to ensure the data is retained.

Allow value to be changed after initial submission

This option is enabled by default. When active, end users can edit the value entered in this field after creating a submission. Disable this option if you want the initial value to remain uneditable once submitted.

Block Width

Desktop View: Set the width of the PDF Viewer block in the desktop view. Options are 100%, 75%, 50%, or 25%.

Mobile View: Set the width of the PDF Viewer block in the mobile view. Options are 100% or 50%.

Variable Name

This is the unique identifier for the Email Input field, which can be used in formulas or references within the app. This appears automatically after saving your configuration of the Number Input block.

Using the Block in App Home

The Number Input block is designed to accept only numeric inputs. It does not allow users to enter any non-numeric characters, such as letters or symbols. This ensures that only valid numbers are entered into the field.

It will also give an error message if a value is entered less than the minimum value.

Note

If you need to format the data in a specific way, such as including prefixes, suffixes, or custom ID formats, consider using the Calculations & Logic block. The Number Input block itself strictly enforces numeric input, so using it for specific formats (like IDs) may require additional configuration in Calculations & Logic for proper formatting.