# tmux.CopyModeRequest

- **Module:** tmux
- **Package:** github.com/libtmux/libtmux-go/tmux
- **Language:** Go
- **Kind:** struct
- **Source:** https://github.com/libtmux/libtmux-go/blob/5f808882015a975a65acc7f9da5b3ff0d5cbdc91/tmux/pane_modes.go#L15
- **Page:** https://libtmux.org/reference/go/tmux-copymoderequest/

CopyModeRequest configures tmux copy mode. Its zero value enters copy mode on the receiver without scrolling. Fields may be combined. tmux resolves the receiver and optional SourcePane before processing Cancel, so a stale target can prevent reset. After resolution, Cancel takes precedence over other actions, though SourcePane validation and the PageDown version probe still occur first.

## Members

- `ScrollUp` (attribute) — ScrollUp enters copy mode one page above the current position.
- `ExitOnBottom` (attribute) — ExitOnBottom makes copy mode exit after scrolling back to the visible screen, until another non-scrolling key disables that behavior.
- `MouseDrag` (attribute) — MouseDrag begins a copy-mode mouse drag and is meaningful from a mouse binding.
- `PageDown` (attribute) — PageDown enters copy mode one page below the current position. It requires tmux 3.5 and follows UnsupportedPolicy. Its version probe still occurs when Cancel is set.
- `SourcePane` (attribute) — SourcePane selects a stable pane whose content is copied while the receiver remains the pane placed in copy mode. Zero uses the receiver. A nonzero value is validated by the library and resolved by tmux even when Cancel is set; a stale or nonexistent pane can prevent cancellation.
- `Cancel` (attribute) — Cancel exits copy mode and any other active pane mode after tmux resolves the receiver and optional SourcePane. A resolution failure prevents the reset; after successful resolution, tmux ignores the other action fields.