> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# copy

> Write a value to the system clipboard.

Replaces the clipboard contents with the supplied value. Useful for priming a
paste step or simulating data dragged in from outside the browser.

## Parameters

| Parameter | Type                        | Required | Description                                                           |
| --------- | --------------------------- | -------- | --------------------------------------------------------------------- |
| `value`   | `string \| boolean \| null` | Yes      | Value to write to the clipboard.                                      |
| `saveAs`  | `string`                    | No       | Name of the variable to write this step's return value to.            |
| `retries` | `number`                    | No       | Number of times to retry the step on failure before failing the test. |
| `skipped` | `boolean`                   | No       | Skip this step at execution time.                                     |

## Shorthand

Value as a string, boolean, or null.

```yaml theme={null}
- copy: hello world
```

## Examples

```yaml theme={null}
- copy:
    value: "{{ env.PAYLOAD }}"
```

```yaml theme={null}
- copy:
    value: null
```

## Related

* [Test format](/core-concepts/test-format)