Skip to content

Switch Window Activity

The Switch Window activity changes automation focus to a different window belonging to the same native Windows desktop application instance, identified by its title.

Field Description Requirement
Application instance The reference name of the application instance previously opened or attached. Required
Reference element An optional JSON-based selector used to help disambiguate between candidate windows. Optional
Window title The title of the target window to switch focus to. Required
Match type Defines how Window title is compared against candidate windows (e.g., Equals, Contains). Optional
Retry count The number of times the activity will retry finding the target window before failing. Optional

Action Types & Examples

Window Switch

  • Format: string
  • Example Result: "Save As"

Implementation Examples

Field Setup - Application instance: ${appInstance} - Window title: Save As - Match type: Contains

Execution Parameters - Retry count: 5

Technical Notes

Increasing Retry count helps avoid failures when the target window (such as a dialog) takes a moment to open after the action that triggers it.