---
title: "Step reference"
section: "Step reference"
description: "Reference of every SmartestQA test step: browser, mobile and desktop actions, checks, waits, variables, code, API, database, mail, Kafka, Network, AI and load tests."
url: https://docs.smartestqa.ai/en/automate-steps.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "step types test step reference action assertion python javascript ai step api request network database jdbc mail kafka jmeter k6 global parameter template mobile desktop step toolbar"
---
# Step reference

A test case is a list of steps. This reference lists every step type SmartestQA offers, which project types have it, where you add it, and what happens to the run when it passes or fails.

## In short

**On this page you can**

- Find the right step type for a task, from a click to a database query.
- See which step types exist in WEB , MOBILE and DESKTOP projects.
- Learn which failures stop a test case and which only mark the step.
- Look up the variables each step produces and how later steps read them.
- Open the family page with fields, examples and errors for each step.

**How to use it**

1. Open a test case in Automate and look at the step toolbar above the step list.
2. Pick a button such as Action , Assert or API , or open More for the rest.
3. Fill the step’s dialog, then select the step to set its values in the right panel.
4. Pass values between steps with {{tc:name}} variables.
5. Click Save , then Dry Run to see each step’s result in the live log.

**At a glance**

- **Where:** **[Automate](https://docs.smartestqa.ai/en/automate.html)** › [a test case](https://docs.smartestqa.ai/en/automate-test-cases.html) › the [step toolbar](https://docs.smartestqa.ai/en/automate-add-steps.html#toolbar) above the step list. Less common types are under **More**.
- **Who:** Every user of the project can add, change and remove steps. There is no [role check](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) on steps.
- **Two kinds:** **Action steps** point at an [action from Discover](https://docs.smartestqa.ai/en/discover-actions.html) (a control on a page). **Step-type steps** (Assert, Python, API, Mail…) are created by their own dialog.
- **Values:** Each step has [parameters](https://docs.smartestqa.ai/en/automate-editor.html#step-parameters) in the right panel. Any value can contain a [variable](https://docs.smartestqa.ai/en/automate-test-data.html#variables) such as `{{tc:orderId}}`.
- **Results:** Each step ends as SUCCESS, FAILED or ERROR (Network steps can also end as WARNING).
- **Runs in:** [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) from the editor, [pipelines in Schedule](https://docs.smartestqa.ai/en/schedule-create.html), on the [server](https://docs.smartestqa.ai/en/schedule-where.html#server) or on [your agent](https://docs.smartestqa.ai/en/agent-pool-agents.html). The same steps run in all of them.
- **Project types:** [WEB, MOBILE (Android and iOS) and DESKTOP (Windows and macOS)](https://docs.smartestqa.ai/en/quick-start-project.html#project-type) each have their own action types. Assertion, Python, API, Database, Mail, Kafka, Global parameter, Wait and AI exist in all three. JavaScript and Network are web only. JMeter and k6 are web and desktop.

## Start from your question

I want to…

- [Check that a value is what I expect](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-step)
- [Use a value from an earlier step](https://docs.smartestqa.ai/en/automate-steps-variables.html#pass-values)
- [Read a one-time code from an email](https://docs.smartestqa.ai/en/automate-steps-mail.html#extract-otp)
- [Call an API in the middle of a UI test](https://docs.smartestqa.ai/en/automate-steps-api.html#add-api-step)
- [Run steps only if a condition is true](https://docs.smartestqa.ai/en/automate-steps-flow.html#if-else)
- [Turn API steps into a load test](https://docs.smartestqa.ai/en/automate-steps-load.html)

Something is wrong

- [A step can’t find its element](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-element-not-found)
- [Type added text to the old value](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-type-appends)
- [My API step passed on a 404](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-api-404-passes)
- [A variable was typed as `{{name}}`](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html#fix-variable-literal)
- [All step problems](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html)

How does it work?

- [Which failures stop the test case](https://docs.smartestqa.ai/en/automate-steps.html#stop-or-continue)
- [What SUCCESS, FAILED and ERROR mean](https://docs.smartestqa.ai/en/automate-steps.html#statuses)
- [How long a step waits for its element](https://docs.smartestqa.ai/en/automate-steps-flow.html#timeouts)
- [How Equals compares numbers and text](https://docs.smartestqa.ai/en/automate-steps-assertions.html#comparison-rules)
- [Where database and mail steps connect from](https://docs.smartestqa.ai/en/automate-steps.html#where-steps-run)

## Where steps fit

Steps are built in **Automate**, the third stage of the order of work. Action steps reuse the actions you captured in Discover; [pipelines in Schedule](https://docs.smartestqa.ai/en/schedule.html) run the finished test cases.

1. **Discover** — Actions and pages
2. **Analyze** — Requirements
3. **Automate** — Steps in test cases ← this page
4. **Schedule** — Pipelines run them
5. **Report** — Step results
6. **Maintenance** — Heal and review

For the editor itself (creating test cases, the step list, saving, Dry Run), see [Automate](https://docs.smartestqa.ai/en/automate.html). To capture actions first, see [Discover › Actions](https://docs.smartestqa.ai/en/discover-actions.html).

## All step families

The toolbar shows the everyday types. Everything else is in **More**, grouped under **Basic**, **Integrations** and **Load test**. When the toolbar is too narrow, buttons that do not fit move into **More** as well.

| Family | Step types | Project types | Added from |
| --- | --- | --- | --- |
| [Browser actions](https://docs.smartestqa.ai/en/automate-steps-browser.html) | Click, Double Click, Right Click, Hover, Type, Clear & Type, Select, Navigate, Get, Visibility Check, Wait (seconds) | WEB | **Action**, **Record** |
| [Mobile actions](https://docs.smartestqa.ai/en/automate-steps-mobile.html) | Tap, Swipe, Scroll, Type Text, Launch App, Press Back, Get Text, Wait For Element, Assert Text and 25 more | MOBILE | **Action**, [**Global**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#global-actions), the [Appium Inspector](https://docs.smartestqa.ai/en/automate-add-steps.html#record-mobile-desktop) |
| [Desktop actions](https://docs.smartestqa.ai/en/automate-steps-desktop.html) | Click, Type Text, Type Key by Key, Press Key, Select, Switch Window, Assert Enabled and 24 more | DESKTOP | **Action**, [**Global**](https://docs.smartestqa.ai/en/automate-steps-mobile.html#global-actions), the [Desktop Recorder](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop) |
| [Checks and assertions](https://docs.smartestqa.ai/en/automate-steps-assertions.html) | Assertion ([**Assert**](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-step)), Visibility Check, AI Check, Network Check, mobile and desktop Assert actions | All | **Assert** |
| [Waits, conditions and templates](https://docs.smartestqa.ai/en/automate-steps-flow.html) | Wait (seconds), Wait For… actions, IF / ELIF / ELSE / END, Template | All | **Action**, [**Python**](https://docs.smartestqa.ai/en/automate-steps-code.html#add-code-step), **Template** |
| [Data and variables](https://docs.smartestqa.ai/en/automate-steps-variables.html) | Global parameter, Get, step outputs, [data sources](https://docs.smartestqa.ai/en/data-source.html) | All | **More** › [**Global parameter**](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter) |
| [Code](https://docs.smartestqa.ai/en/automate-steps-code.html) | Python, JavaScript | Python: all. JS: WEB | [**Python**](https://docs.smartestqa.ai/en/automate-steps-code.html#add-code-step), [**JS**](https://docs.smartestqa.ai/en/automate-steps-code.html#add-code-step) |
| [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.html) | AI Ask, AI Check, AI Do, AI Chat | All | [**AI step**](https://docs.smartestqa.ai/en/automate-steps-ai.html#add-ai-step) |
| [API](https://docs.smartestqa.ai/en/automate-steps-api.html) | [API Request](https://docs.smartestqa.ai/en/api-requests-in-tests.html#add-step) | All | [**API**](https://docs.smartestqa.ai/en/automate-steps-api.html#add-api-step) |
| [Network](https://docs.smartestqa.ai/en/automate-steps-network.html) | Check, Get value, List (browser calls) | WEB | [**Network**](https://docs.smartestqa.ai/en/automate-steps-network.html#add-network-step) |
| [Database](https://docs.smartestqa.ai/en/automate-steps-database.html) | DB (SQL query) | All | **More** › [**Database**](https://docs.smartestqa.ai/en/automate-steps-database.html#add-db-step) |
| [Mail](https://docs.smartestqa.ai/en/automate-steps-mail.html) | Get Mails, Extract OTP, Extract Link, Send Mail, Wait for Mail | All | **More** › [**Mail**](https://docs.smartestqa.ai/en/automate-steps-mail.html#add-mail-step) |
| [Kafka](https://docs.smartestqa.ai/en/automate-steps-kafka.html) | Kafka Produce, Kafka Consume | All | **More** › [**Kafka**](https://docs.smartestqa.ai/en/automate-steps-kafka.html#add-kafka-step) |
| [Load tests](https://docs.smartestqa.ai/en/automate-steps-load.html) | JMeter, k6 | WEB, DESKTOP | **More** › [**JMeter**](https://docs.smartestqa.ai/en/automate-steps-load.html#upload) / [**k6**](https://docs.smartestqa.ai/en/automate-steps-load.html#upload) |

![The step toolbar and the **More** menu.](https://docs.smartestqa.ai/media/shots/STP-SHOT-01.png)

## The building blocks

- **Step:** One line in a test case. It runs in order, from step 1 down. A step has a name, a type, and parameters.
- **Action step:** A step that points at a [shared action](https://docs.smartestqa.ai/en/discover-actions.html) (for example `Click Sign In` on page `login`). Fixing the action’s locator fixes every test that uses it. The step list [shows how many test cases use the action](https://docs.smartestqa.ai/en/automate-numbers.html#usage-chip).
- **Step-type step:** A step created by its own dialog: Assertion, Python, JavaScript, AI, API, Network, Database, Mail, Kafka, Global parameter, JMeter, k6. These are not in the [Action List](https://docs.smartestqa.ai/en/automate-add-steps.html#action-list) and belong to one test case.
- **Parameter:** A key and a value on the step, shown in the right panel under [**Parameters List**](https://docs.smartestqa.ai/en/automate-editor.html#step-parameters). For a Type step the value is the text to type; for a Get step the key is the name of the variable to fill.
- **Variable:** A value saved by one step and read by a later one, written `{{tc:name}}`. See [Data and variables](https://docs.smartestqa.ai/en/automate-steps-variables.html).
- **Output:** The variable a step writes: the Get key, an API JSON path, SQL output values, a mail OTP, a code step’s returned value.
- **Template:** A test case [marked as a template](https://docs.smartestqa.ai/en/automate-test-cases.html#case-kind), added inside another case as one step. Its steps run in place. See [Templates](https://docs.smartestqa.ai/en/automate-steps-flow.html#template).

## Step results

Every step reports one status in the [live log](https://docs.smartestqa.ai/en/automate-dry-run.html#live-log) of a Dry Run and in the [report](https://docs.smartestqa.ai/en/report-steps.html#step-table) of a pipeline run.

| Status | Meaning | Typical causes |
| --- | --- | --- |
| SUCCESS | The step did what it should. | Element clicked, assertion met, query returned rows. |
| FAILED | A check ran and did not pass. | Assertion not met, Visibility Check false, Network check failed, AI Check answered false, load test with failed requests. |
| ERROR | The step could not run. | Element not found, connection refused, wrong SQL, code exception, missing configuration. Reports store it as failed. |
| WARNING | Network step only: failed calls or JS errors were seen and [**On failed calls / JS errors**](https://docs.smartestqa.ai/en/automate-steps-network.html#advanced) is **Mark as warning**. | A 500 response in scope. |
| SKIPPED | Live log only: the step did not run because an earlier step stopped the case. | Any stopping failure above it. |

## Which failures stop the test case

Most failures stop the test case: the remaining steps do not run. A few step types only mark themselves and let the case go on. Plan your checks with this table.

| Step | When it goes wrong | The case… |
| --- | --- | --- |
| Click, Type, Select, Hover and other element actions | Element not found after retries and [auto-heal](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html) | stops |
| Assertion | Condition not met, or configuration error | stops |
| Visibility Check | Element or text not visible | continues (step FAILED) |
| API Request | Any HTTP status, including 4xx and 5xx | continues (step SUCCESS) |
| API Request | Timeout, SSL or connection error | continues (step ERROR) |
| Database, Mail, Kafka | Connection, query or timeout error | stops |
| Network | Check fails, or no matching call with **Fail the step** | stops |
| Python, JavaScript | Exception, or STATUS output is false | stops |
| AI step | AI error or a failed AI Check | stops for steps added from the dialog (they are created with stop-on-error); continues otherwise |
| JMeter, k6 | Failed requests, timeout, tool missing | the step ends as ERROR in the report |

> **Tip: Check API results yourself**
>
> An API step passes on any HTTP answer. Save `@status` into a variable and add an [Assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-step) after it. See [Check the status code](https://docs.smartestqa.ai/en/automate-steps-api.html#check-the-status).

## Where steps run

A test case runs on the **[server](https://docs.smartestqa.ai/en/schedule-where.html#server)** (headless, no agent needed) or on your **[agent](https://docs.smartestqa.ai/en/agent-pool-agents.html)** (the SmartTest app on your computer). Steps that connect to other systems connect from that machine.

| What the step reaches | Connects from | Watch out |
| --- | --- | --- |
| Your app’s UI (web, mobile, desktop) | The browser, device or desktop session of the run | Mobile runs need a [device](https://docs.smartestqa.ai/en/agent-pool-devices.html#devices) or [emulator](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#android-emulator); desktop runs need an agent on the [Windows](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#windows-desktop) or [macOS](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#macos-desktop) computer with the app. |
| API, Database, Mail, Kafka | The machine that runs the test | A [database](https://docs.smartestqa.ai/en/data-source-connections.html#add-db) in your office network is not reachable from the server. [Run on your agent](https://docs.smartestqa.ai/en/schedule-where.html#agent). |
| AI steps | The project’s [AI provider](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) | AI must be [enabled for the project](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai). |
| JMeter, k6 | The machine that runs the test | [JMeter must be installed there](https://docs.smartestqa.ai/en/automate-steps-load.html#run-time). k6 is downloaded automatically unless that is turned off. |

Differences between a [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) and a pipeline run that matter for steps:

- A Dry Run uses only the [first row of a data source](https://docs.smartestqa.ai/en/automate-test-data.html#data-driven) and does not [retry a failed test case](https://docs.smartestqa.ai/en/project-settings-test-management.html#retry-math).
- Every step gets a screenshot in a Dry Run. Dry Run results are [not saved to reports](https://docs.smartestqa.ai/en/automate-dry-run.html#run-modes).
- Load-test steps run with their own defaults in a Dry Run (k6: one user, one iteration). [Pipeline load settings](https://docs.smartestqa.ai/en/schedule-settings.html#mobile-desktop-load) apply only in Schedule.

## Best practices

#### Do

- End every flow with a check: an Assertion, a Visibility Check or an AI Check.
- Use **Clear & Type** for fields that already contain text.
- Name variables after what they hold: `orderId`, not `value1`.
- Put a login or setup sequence in a [template](https://docs.smartestqa.ai/en/automate-steps-flow.html#template) and reuse it.
- Assert on `@status` after every [API step](https://docs.smartestqa.ai/en/automate-steps-api.html#check-the-status) that must succeed.
- Run database, mail and Kafka steps on an [agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) inside your network.

#### Don’t

- Add fixed waits to fix timing. Use a [Wait For… step](https://docs.smartestqa.ai/en/automate-steps-flow.html#waits) or a check that waits.
- Rely on [Visibility Check](https://docs.smartestqa.ai/en/automate-steps-browser.html#visibility-check) to stop a broken flow; it lets the case continue.
- Leave [AI steps](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#when-to-convert) in place once a regular action can do the job.
- Write UPDATE or DELETE queries against shared data without a WHERE clause.
- Mix JMeter or k6 with browser steps; load tests need [their own test case](https://docs.smartestqa.ai/en/automate-steps-load.html#load-only-rule).

## In this section

- [Browser actions](https://docs.smartestqa.ai/en/automate-steps-browser.html) — The web action steps: Click, Double Click, Right Click, Hover, Type, Clear & Type, Select, Navigate, Get, Visibility Check and Wait.
- [Checks and assertions](https://docs.smartestqa.ai/en/automate-steps-assertions.html) — The Assertion step and its types, how values are compared, and which check to use when: Assertion, Visibility Check, AI Check, Network Check and the mobile and desktop Assert actions.
- [Waits, conditions and templates](https://docs.smartestqa.ai/en/automate-steps-flow.html) — Fixed and conditional waits, how long a step waits for its element, IF / ELIF / ELSE / END blocks, and template steps that reuse a whole sequence.
- [Data and variables](https://docs.smartestqa.ai/en/automate-steps-variables.html) — Pass values between steps: the Global parameter step, the Get step and its transforms, which steps produce variables, and the {{tc:}}, {{ds:}} and {{excel:}} reference syntax.
- [Code steps: Python and JavaScript](https://docs.smartestqa.ai/en/automate-steps-code.html) — Write Python or JavaScript in a step, return a value or a pass/fail result, insert ready commands, and build IF / ELSE blocks.
- [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.html) — Ask about the screen, check something visible, act in plain words, or chat with the AI as a step: the four AI modes, their fields and outputs.
- [API Request step](https://docs.smartestqa.ai/en/automate-steps-api.html) — Call an HTTP API inside a test case, try it with Send, save response values with JSON paths, and check the status code.
- [Network step](https://docs.smartestqa.ai/en/automate-steps-network.html) — Check, read or list the calls the browser makes during a web test: status codes, response fields, durations, JS errors.
- [Database step](https://docs.smartestqa.ai/en/automate-steps-database.html) — Run an SQL query against your database inside a test case and save column values as variables.
- [Mail steps](https://docs.smartestqa.ai/en/automate-steps-mail.html) — Read a one-time code or a link from an email, wait for a message, count messages, or send an email during a test.
- [Kafka steps](https://docs.smartestqa.ai/en/automate-steps-kafka.html) — Publish a message to a Kafka topic and wait for a matching message, to test event-driven flows inside a test case.
- [Load test steps: JMeter and k6](https://docs.smartestqa.ai/en/automate-steps-load.html) — Add a JMeter or k6 load test as a step: upload a .jmx or .js file, or generate one with AI from the API steps of a test case.
- [Mobile actions](https://docs.smartestqa.ai/en/automate-steps-mobile.html) — Every Android and iOS action step: touch and gestures, input, app lifecycle, navigation, reading values, waits and assertions, plus the ready-made Global actions.
- [Desktop actions](https://docs.smartestqa.ai/en/automate-steps-desktop.html) — Every Windows and macOS action step: mouse, input and keys, scrolling, waits, assertions, reading values, app and window control, plus Global desktop actions.
- [Step troubleshooting](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.html) — Every step-level message and surprise, from element not found to mail timeouts, with why it happens, what to check and how to fix it.
