Skip to main content
Use __CLEAR__ when you want Cyberdesk to actively blank out a field instead of leaving its current value untouched. __CLEAR__ is explicit. Cyberdesk preserves it as the input value during validation, then turns it into a clear action only when a type step runs on the currently focused field.

​
Simple Use Case

Problem: Some fields already contain text, and leaving an input blank is not enough when you want the final value to be empty. Solution: Use __CLEAR__ to clear the currently focused field with ctrl+a backspace.

​
Example

# User wants to remove the pre-filled middle name
input_values = {"middle_name": "__CLEAR__"}
If a later workflow step types {middle_name} into the focused field, Cyberdesk sends the clear-field shortcut instead of typing the literal text __CLEAR__.

​
How It Differs From __EMPTY__

  • __CLEAR__: actively clears the current field
  • __EMPTY__: skips typing and leaves the current field untouched
  • omitted / blank / null optional values: do not clear the field unless you explicitly pass __CLEAR__
If you want skip behavior instead, see Empty Values.

​
When to Use

  • Pre-filled forms where the field already contains a value
  • Resetting optional fields that should end blank
  • Overriding machine defaults or existing UI state with an intentionally empty result

​
Best Practice

Use __CLEAR__ only when the workflow step is actually typing into the correct focused field and you want the final visible value to be empty. Cyberdesk does not infer it from blank or omitted values; you must pass __CLEAR__ explicitly. For plain skip behavior, use Empty Values instead.