# Convert distance

Converts a unit of distance to another format. Convert distance lives in the **Utils** category of the `fx` menu.

## Parameters

| Parameter    | Type   | Required | Default    | Description                                                                                                                          |
| ------------ | ------ | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Input        | string | yes      | —          | Value to transform. Previous step output or a literal.                                                                               |
| Input units  | string | no       | `[Metric]` | Choose one of: `[Metric]`, `Nanometres (nm)`, `Micrometres (µm)`, `Millimetres (mm)`, `Centimetres (cm)`, `Metres (m)`, and 30 more. |
| Output units | string | no       | `[Metric]` | Choose one of: `[Metric]`, `Nanometres (nm)`, `Micrometres (µm)`, `Millimetres (mm)`, `Centimetres (cm)`, `Metres (m)`, and 30 more. |

`Input` is the primary value (previous step output or a literal).

## Returned value

| Type     | Description                                    |
| -------- | ---------------------------------------------- |
| `string` | Result of the Convert distance transformation. |

## Example

<details>
<summary>Run Convert distance</summary>

Converts a unit of distance to another format. Adjust optional parameters when the defaults do not match your payload.

1. Set **Input** to the value to transform (previous step output or a literal).

2. Review **Input units**, **Output units** and keep defaults unless your format requires otherwise.

3. Confirm **Output value** shows the transformed result.

</details>