# Convert units with the Unit Conversion pipe

> Use the Unit Conversion call of the Tadabase Number Utilities pipe to convert an amount between units, such as centimeters to inches, to a set precision.

Source: https://tadabase.com/docs/pipes/unit-conversion  
Status: Verified Nov 17, 2026. Checked against the current product

**Unit Conversion** is a call in the **Tadabase Number Utilities** pipe. It converts an amount from one unit to another, for example `500` centimeters to inches, and rounds the result to the number of decimal places you choose.

## Install the pipe

1. **Open Pipes** In the builder, click **Pipes** in the left menu, then click **Install Pipe**.
2. **Find the pipe** Type `Number Utilities` in the **Search...** box and click the **Tadabase Number Utilities** card. **Unit Conversion** is listed under **Available Actions**.
3. **Install it** Click **Install**. If the pipe is already installed for another call, skip this; all its calls come with it.

## Parameters

| Parameter | What to enter | Example |
| --- | --- | --- |
| **Amount** | The number to convert. | `500` |
| **From** | The abbreviation of the unit the amount is in. | `cm` (centimeters) |
| **To** | The abbreviation of the unit to convert to. | `in` (inches) |
| **Precision** | How many decimal places to keep in the result. | `1` |

The converted amount is returned as **Response**, as a number.

> **Note:** Check a unit abbreviation before you rely on it: open the pipe's **API Calls** tab, click **Unit Conversion**, open **Test**, enter an **Amount**, **From**, **To** and **Precision**, and click **Test**. The result shows whether the pipe recognized both units.

![The Unit Conversion call of the Tadabase Number Utilities pipe on its Test tab, with Amount, From, To and Precision](https://tadabase.com/docs-shots/pipes-unit-conversion-test.webp)

## Run it on load or on save

Where you add the pipe decides when it runs. [Use pipes in your app](https://tadabase.com/docs/pipes/using-pipes) covers each place.

- **When data is loaded**: add the pipe in the **Pipes** part of a component's **Data Source** tab to show the converted amount each time the component loads.
- **When a record is saved**: run the pipe from a workflow with a **Trigger Pipe** action and save **Response** to a number field.

1. **Choose the call** In the workflow's **Trigger Pipe** action, choose **Unit Conversion** in **Pipe Method**.
2. **Map the input** Under **Parameters**, set **Amount** to your number field, and **From**, **To** and **Precision** to typed values or to fields that hold them.
3. **Save the result** In a later step, update a number field with the **Response** value.
