# Number field

📝

A **Number** field is specifically designed to collect numeric values from users.

## [#](#overview)Overview

Number fields accept only numerical input, making them ideal for quantities, scores, costs, measurements, or any value that needs to be validated, compared, or calculated.

![image-20260527-092349.png](https://help.gocapable.com/images/339b9c65-162b-4f6c-9e30-f417f3d3957a.webp)

## [#](#use-cases)Use cases

Typical use cases include:

* Quantities, counts, or totals
* Budgets, prices, or cost estimates
* Ratings or scores
* Ages, durations, or time estimates
* Percentages or thresholds
* Measurements such as weight, distance, or dimensions

## [#](#configuration)Configuration

You have the following options available when using the number input macro:

![image-20260527-092318.png](https://help.gocapable.com/images/6e4ce3d4-b59f-4ce0-857c-475a78f3b4ab.webp)

| **Setting** | **Recommendation**                                         | **Notes**                                                                    |
| ----------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------- |
| ID          | Use a stable, meaningful internal identifier.              | Avoid renaming once the field is used in filters, reports, or templates.     |
| Label       | Use a short, specific label describing the value expected. | For example: _Quantity_, _Budget (GBP)_, or _Score_.                         |
| Required    | Enable only when the value is essential.                   | If enabled, provide a clear label and help text so users know what to enter. |
| Placeholder | Add an example or prompt to guide the user.                | For example: Enter the total estimated budget in GBP                         |