# write

The `write` step type opens a multi-line text editor prompt, giving your custom commands and workflows a place to collect longer free-form input such as release notes or commit messages.

```yaml
steps:
  - name: notes
    type: write
    prompt: Release notes
    placeholder: Summarize the change
    height: 8
```

## Fields

- **`prompt`**
  Required. Prompt text shown to the user.
- **`placeholder`**
  Optional placeholder text.
- **`height`**
  Optional editor height in lines.

Interactive steps require a TTY. Reference the text later with `{{ .steps.notes.value }}`.
