# Convert mass

Converts a unit of mass to another format. Convert mass 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]`, `Yoctogram (yg)`, `Zeptogram (zg)`, `Attogram (ag)`, `Femtogram (fg)`, `Picogram (pg)`, and 72 more. |
| Output units | string | no       | `[Metric]` | Choose one of: `[Metric]`, `Yoctogram (yg)`, `Zeptogram (zg)`, `Attogram (ag)`, `Femtogram (fg)`, `Picogram (pg)`, and 72 more. |

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

## Returned value

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

## Example

<details>
<summary>Run Convert mass</summary>

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