> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Number

> Store numeric data such as prices, inventory, quantities, and ratios. Supports decimals, currency, percentage, and visual displays.

A **Number** field stores values that can be calculated, such as prices, inventory, quantities, scores, and ratios. It supports number, currency, and percentage formats, and can show values as bars, rings, or lines.

## Use Cases

| Scenario                 | Good for                                           |
| ------------------------ | -------------------------------------------------- |
| Amounts and costs        | Contract amounts, product prices, budgets, costs   |
| Quantities and inventory | Stock counts, order quantities, work hours, counts |
| Ratios and progress      | Achievement rate, conversion rate, completion rate |
| Scores and metrics       | Scores, weights, health scores, risk scores        |

## Create and Configure

<Steps>
  <Step title="Choose the field type">
    Click the `+` on the right side of the table header, then choose **Number** from the field type list.
  </Step>

  <Step title="Name the field">
    Enter a field name, such as "Product Price", "Inventory", or "Achievement Rate".
  </Step>

  <Step title="Choose the number format">
    Choose **Number**, **Currency**, or **Percentage** based on the data.
  </Step>

  <Step title="Set precision and default value">
    Set decimal places, and add a default value for new records if needed.
  </Step>
</Steps>

## Number Formats

| Format     | Good for                           | Example      |
| ---------- | ---------------------------------- | ------------ |
| Number     | Counts, quantities, scores         | `100`, `2.5` |
| Currency   | Amounts, costs, budgets            | `$100.00`    |
| Percentage | Ratios, progress, conversion rates | `50%`        |

Precision controls how many decimal places are shown. After precision is set, Teable rounds displayed values to that precision.

## Display Settings

Number fields can show values visually in addition to plain text.

| Display mode | Good for                             | Description                                     |
| ------------ | ------------------------------------ | ----------------------------------------------- |
| Default      | Single-value and multi-value numbers | Shows the number directly                       |
| Bar          | Single-value and multi-value numbers | Uses bar length to show value size              |
| Ring         | Single-value numbers                 | Uses a ring progress display to show proportion |
| Line         | Multi-value numbers                  | Uses a line to show changes across values       |

For Bar and Ring display, you can set a target value, color, and whether to show the number. The target value is the value that fills the visual display. For example, if the full score is `100`, set the target value to `100`.

## Common Uses

* **Contract amounts**: Create a "Contract Amount" field, choose **Currency**, select `$`, and set precision to 2 decimal places.
* **Sales achievement rate**: Create an "Achievement Rate" field, choose **Percentage**, set display mode to **Bar**, and set the target value to `1`.
* **Inventory management**: Create an "Inventory" field, choose **Number**, then use it for sorting, filtering, and summaries.

## Notes

* Number fields only accept integers and decimals, such as `12` and `3.14`.
* Percentages are stored as decimals. Entering `100%` stores `1`; entering `50%` stores `0.5`.
* If Formula, Rollup, or Lookup results are numeric, they can use Number field formatting and display modes.