# Pad lines

Add the specified number of the specified character to the beginning or end of each line. Pad lines 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. |
| Position  | string | no       | `Start` | Choose one of: `Start`, `End`.                         |
| Length    | number | no       | `5`     | Numeric value. Default `5`.                            |
| Character | string | no       | ` `     | Argument value for this operation.                     |

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

## Returned value

| Type     | Description                             |
| -------- | --------------------------------------- |
| `string` | Result of the Pad lines transformation. |

## Example

<details>
<summary>Run Pad lines</summary>

Add the specified number of the specified character to the beginning or end of each line 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 **Position**, **Length**, **Character** and keep defaults unless your format requires otherwise.

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

</details>