Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

🔀 Keyboard

Branch on clipboard content in RunMacro

What it does

The IF Clipboard command checks the clipboard against a condition and steers the workflow: if true it jumps to one label, if false to another. It is a branching tool based on copied data.

When to use it

Only continue when the clipboard contains a certain string.
Skip/stop when the clipboard is empty.
Classify data: digits-only, letters-only, equals a value...

Configuration steps

Make sure the clipboard has data (Copy Text or Set Clipboard first).
Add a Keyboard › IF Clipboard command.
Choose the comparison (equals, contains, greater, empty, digits, letters) and enter the target value.
Set the IF label (if true) and ELSE label (if false).
Place the commands to run under the matching label. Save.

Every option explained

Comparison mode

Equals, Contains, Greater (number), Empty, Digits only, Letters only.

Target value

For Equals/Contains: the string/number to compare — you can enter multiple values (per line or comma) with ANY/ALL mode. For Digits only/Letters only: this field is the set of extra allowed characters besides digits/letters (not a value to compare).

ANY / ALL (match mode)

With multiple values: ANY is true if at least one matches; ALL is true if all match.

Negate (NOT)

Enable to invert the result (true becomes false and vice versa).

IF label / ELSE label

The label to jump to when true (IF) and when false (ELSE). Create labels with the Label command.

Real example

Example: continue only if clipboard contains "OK"

Copy the status text into the clipboard.
IF Clipboard, mode Contains, target "OK", IF label = continue, ELSE label = finish.
Put the handling steps under the continue label.

Tips & common mistakes

Combine Copy Text → IF Clipboard to read on-screen status then decide the flow.

You must create the matching Label for the jump to work.