# Convert speed

Converts a unit of speed to another format. Convert speed 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]`, `Metres per second (m/s)`, `Kilometres per hour (km/h)`, `[/Metric]`, `[Imperial]`, `Miles per hour (mph)`, and 27 more. |
| Output units | string | no       | `[Metric]` | Choose one of: `[Metric]`, `Metres per second (m/s)`, `Kilometres per hour (km/h)`, `[/Metric]`, `[Imperial]`, `Miles per hour (mph)`, and 27 more. |

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

## Returned value

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

## Example

<details>
<summary>Run Convert speed</summary>

Converts a unit of speed 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>