---
title: "Desktop actions"
section: "Step reference"
description: "Reference of SmartestQA desktop steps for Windows and macOS apps: what each action does, the value it needs, outputs, Global Desktop Actions and run-time rules."
url: https://docs.smartestqa.ai/en/automate-steps-desktop.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "desktop action windows macos click type text type key by key press key shortcut select combo box scroll to element assert enabled assert checked switch window maximize screenshot global desktop actions agent"
---
# Step reference: Desktop actions

Desktop projects test Windows and macOS applications through an agent on the machine where the app runs. This page lists every desktop action type and the value each one needs.

## In short

**On this page you can**

- Click, double-click, right-click and hover controls of a desktop app.
- Type text, type key by key for password fields, and press shortcuts such as Ctrl+S.
- Check that a control is visible, exists, is enabled or is checked.
- Read a control’s text or attribute into a variable.
- Launch or close the app, switch or maximize windows, take screenshots.

**How to use it**

1. Start the SmartTest agent on the machine that has the app.
2. Capture controls with the Desktop Recorder , or pick saved actions with Action .
3. Add locator-free steps such as Press Enter or Wait 2 Seconds with Global .
4. Fill each step’s value: text, key, option, variable name or window title.
5. Save and run a Dry Run on the agent.

## How desktop steps are created

- **Desktop Recorder.** Captures controls of the running app on the [agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) machine and adds them as steps. See [Discover › Desktop](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop).
- **Action.** Pick saved desktop actions from the [Action List](https://docs.smartestqa.ai/en/automate-add-steps.html#action-list).
- **[**Global**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#global-actions).** Ready-made steps that need no control. See [Global desktop actions](https://docs.smartestqa.ai/en/automate-steps-desktop.html#global-desktop).

The types below exist only in **DESKTOP** projects. Shared step types ([Assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html), [Python](https://docs.smartestqa.ai/en/automate-steps-code.html), [API](https://docs.smartestqa.ai/en/automate-steps-api.html), [Database](https://docs.smartestqa.ai/en/automate-steps-database.html), [Mail](https://docs.smartestqa.ai/en/automate-steps-mail.html), [Kafka](https://docs.smartestqa.ai/en/automate-steps-kafka.html), [Global parameter](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter), [Wait (seconds)](https://docs.smartestqa.ai/en/automate-steps-browser.html#wait-seconds), [AI](https://docs.smartestqa.ai/en/automate-steps-ai.html), [JMeter, k6](https://docs.smartestqa.ai/en/automate-steps-load.html)) work here too. JavaScript and [Network](https://docs.smartestqa.ai/en/automate-steps-network.html) are not available in desktop projects.

## Mouse

| Action | Does | Value |
| --- | --- | --- |
| Click | Clicks a desktop control. | — |
| Double Click | Double-clicks a control. | — |
| Right Click | Right-clicks a control (opens the context menu). | — |
| Hover | Moves the mouse over a control. | — |

## Input and keys

| Action | Does | Value |
| --- | --- | --- |
| Type Text | Types text into a control. | The text |
| Clear | Clears the value of a control. | — |
| Clear & Type | Clears the control, then types. | The text |
| Type Key by Key | Types with the real keyboard, one key at a time. Use it for password fields and fields that reject pasted or bulk input. | The text |
| Press Key | Presses a key or a combination. | `Enter`, `Tab`, `Esc`, `Ctrl+S`, `Alt+F4` |
| Select | Selects an option in a combo box or list. | The option |

## Scrolling and waits

| Action | Does | Value |
| --- | --- | --- |
| Scroll | Scrolls with the mouse wheel. | Direction: up, down, left, right |
| Scroll To Element | Scrolls until the control is visible. | — |
| Wait For Element | Waits until the control exists. | — |
| Wait For Visible | Waits until the control is visible. | — |
| Wait | Waits for the given number of seconds. | Seconds |

The shared [Wait (seconds)](https://docs.smartestqa.ai/en/automate-steps-browser.html#wait-seconds) step does the same as Wait and is the one to use in new steps.

## Assertions

| Action | Passes when | Value |
| --- | --- | --- |
| Assert Visible | The control is visible. | — |
| Assert Not Visible | The control is not visible. | — |
| Assert Exists | The control exists. | — |
| Assert Not Exists | The control does not exist. | — |
| Assert Enabled | The control is enabled. | — |
| Assert Checked | The checkbox or toggle is checked. | — |
| Assert Text | The control’s text equals the expected value. | The expected text |

The Desktop Recorder offers the most used types. Wait For Element, Assert Exists, Assert Not Exists, Assert Text and Store Variable are not in its menu because other types cover them (Wait For Visible, Assert Visible, Assert Not Visible, Get Text plus an [Assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-step)), but existing steps of these types keep running.

## Read values

| Action | Does | You fill |
| --- | --- | --- |
| Get Text | Reads the control’s text into a variable. | The variable name |
| Get Attribute | Reads a control attribute into a variable. | The variable name and the attribute |
| Store Variable | Stores a value in a variable. | The variable name and the value |

Later steps read the value as [`{{tc:name}}`](https://docs.smartestqa.ai/en/automate-test-data.html#variables) or pick it with [**Insert step variable**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#data). These steps accept the [per-step **Timeout**](https://docs.smartestqa.ai/en/automate-steps-flow.html#timeouts) (1–300 seconds).

## App and window

| Action | Does | Value |
| --- | --- | --- |
| Launch App | Launches the application under test (from the [project’s desktop settings](https://docs.smartestqa.ai/en/project-settings-desktop.html#applications)). | — |
| Close App | Closes the application under test. | — |
| Switch Window | Switches to the window whose title contains the value. | Part of the window title |
| Maximize Window | Maximizes the current window. | — |
| Screenshot | Takes a screenshot for the [report](https://docs.smartestqa.ai/en/report-steps.html#screenshots). | — |

## Global desktop actions

[**Global**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#global-actions) opens **Global Desktop Actions**: “Ready-made desktop steps that need no element (keys, wait, app/window)”. Click [**Add to step list**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#global-actions) on a row.

| Global action | Type and value |
| --- | --- |
| Press Enter, Press Tab, Press Escape | Press Key: `Enter`, `Tab`, `Esc` |
| Save (Ctrl+S) | Press Key: `Ctrl+S` |
| Wait 2 Seconds | Wait: 2 |
| Scroll Down, Scroll Up | Scroll: down, up |
| Launch App, Close App | Launch App, Close App |
| Maximize Window | Maximize Window |
| Take Screenshot | Screenshot |

## At run time

- **Agent required.** Desktop steps run on an [online SmartTest agent](https://docs.smartestqa.ai/en/agent-pool-agents.html#agent-status) on the machine with the app. A [Dry Run](https://docs.smartestqa.ai/en/automate-dry-run.html#desktop-dry-run) lists the agents under **Device (agent)**. See [Install the agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).
- **Healing.** Desktop locators can be [auto-healed](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#project-types) when the [project’s AI](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) is on; repairs wait for review in [Maintenance](https://docs.smartestqa.ai/en/maintenance-auto-heal.html).
- **Logs.** Each type writes a plain message, for example `"Save" was clicked`, `Key "Ctrl+S" was pressed` or `"OK" is not enabled`.

## If something goes wrong

- [No agent is found or the agent is offline](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-desktop-agent)
- [Typing into a password field does nothing](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-desktop-password)
- [The step works on the wrong window](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-desktop-window)
