# Pad text to equal length

Pads the input text to the specified length with the specified character. Pad text to equal length lives in the **Custom** category of the `fx` menu.

## Parameters

| Parameter    | Type   | Required | Default | Description                                            |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------ |
| Input        | string | yes      | —       | Value to transform. Previous step output or a literal. |
| Total length | number | yes      | `0`     | Argument value.                                        |
| Character    | string | yes      | `*`     | Argument value.                                        |
| Direction    | string | no       | `End`   | Argument value.                                        |

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

## Returned value

| Type     | Description                                            |
| -------- | ------------------------------------------------------ |
| `string` | Result of the Pad text to equal length transformation. |

## Example

<details>
<summary>Run Pad text to equal length</summary>

Pads the input text to the specified length with the specified character. 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 **Total length**, **Character**, **Direction** and keep defaults unless your format requires otherwise.

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

</details>