---
title: "Automate"
section: "Automate"
description: "Automate is where you build SmartestQA test cases: organise them in folders, record or add steps, give them test data, and try them with a dry run."
url: https://docs.smartestqa.ai/en/automate.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "automate overview test case editor test case tree steps record dry run template folder module parameters test data"
---
# Automate

Automate is where you build test cases: you organise them in folders, record or add their steps, give them test data and try them with a dry run. Pipelines in Schedule then run them and keep the results.

## In short

**On this page you can**

- Create test cases and templates and organise them in folders and modules.
- Record steps in your app, or add them from the toolbar one by one.
- Feed steps with variables, data sources and datasets.
- Try a test case with a Dry Run and read its live log.
- Let AI write steps from a prompt or expand a case into edge cases.

**How to use it**

1. Click New Test Case in the tree and type a name at the top.
2. Pick the environment and start page, then click Record or add steps from the toolbar.
3. Select each step and check its values in the right panel.
4. Click Save , then Dry Run until the run is green.
5. Add the test case to a pipeline in Schedule so its runs are reported.

**At a glance**

- **Where:** Main menu › **Automate**, the third item. One screen with three panels: test case tree, editor, details.
- **Who:** Every project member can create and edit. Archiving other people’s work, modules and **Delete for good** need an [Admin](https://docs.smartestqa.ai/en/company-settings-roles.html).
- **You need:** Web: the [browser extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension) and a [start page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url). Mobile and desktop: a [running agent](https://docs.smartestqa.ai/en/agent-pool-agents.html). [Actions from Discover](https://docs.smartestqa.ai/en/discover-actions.html) help but are not required.
- **Time:** A recorded five-step test takes a few minutes, including the first [dry run](https://docs.smartestqa.ai/en/automate-dry-run.html).
- **Produces:** **Test cases** and **templates** with ordered steps, each step bound to an action, plus the variables the steps share.
- **Used by:** [Schedule](https://docs.smartestqa.ai/en/schedule-create.html#add-content) (pipelines run test cases), [Report](https://docs.smartestqa.ai/en/report.html), [Analyze](https://docs.smartestqa.ai/en/analyze-test-cases.html) (requirement links), [Maintenance](https://docs.smartestqa.ai/en/maintenance-auto-heal.html) (auto-heal reviews) and AI assistants through [MCP](https://docs.smartestqa.ai/en/mcp.html).
- **Project types:** WEB: **Record** through the extension, start page URL per environment, **Run on Server** or **Run on your Agent**. MOBILE: **Record** opens the [Appium inspector](https://docs.smartestqa.ai/en/automate-add-steps.html#record-mobile-desktop), [dry run on a local device](https://docs.smartestqa.ai/en/automate-dry-run.html#mobile-dry-run) or [Device Farm](https://docs.smartestqa.ai/en/agent-pool.html). DESKTOP: **Record** opens the desktop inspector, the test targets a [desktop application](https://docs.smartestqa.ai/en/project-settings-desktop.html#applications) and runs on an agent on [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).

## Start from your question

I want to…

- [Create a test case](https://docs.smartestqa.ai/en/automate-test-cases.html#create-test-case)
- [Record steps in my web app](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web)
- [Make a reusable template](https://docs.smartestqa.ai/en/automate-test-cases.html#case-kind)
- [Run one test with many rows of data](https://docs.smartestqa.ai/en/automate-test-data.html#data-driven)
- [Try a test case right now](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run)
- [Let AI write the steps](https://docs.smartestqa.ai/en/automate-ai.html#generate-from-prompt)

Something is wrong

- [The Save button is grey](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-save-disabled)
- [“Test case not be updated”](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-case-not-updated)
- [I can’t start a dry run](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-dry-run-disabled)
- [The tree icon did not change after a dry run](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-status-unchanged)
- [I can’t delete a test case](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-archive-template)
- [All Automate problems](https://docs.smartestqa.ai/en/automate-troubleshooting.html)

How does it work?

- [Dry run vs pipeline run vs agent](https://docs.smartestqa.ai/en/automate-dry-run.html#run-modes)
- [Why renaming a step changes other tests](https://docs.smartestqa.ai/en/automate-editor.html#rename-step)
- [Where a {{variable}} gets its value](https://docs.smartestqa.ai/en/automate-test-data.html#resolution)
- [What the tree status icon means](https://docs.smartestqa.ai/en/automate-numbers.html#status-icon)
- [What is saved without clicking Save](https://docs.smartestqa.ai/en/automate-editor.html#saved-at-once)

## Where Automate fits

The main menu is the order of work. Automate turns what Discover and Analyze know about your app into runnable test cases.

1. **Discover** — Pages, controls, rules
2. **Analyze** — Requirements
3. **Automate** — Test cases and steps ← this page
4. **Schedule** — Pipelines
5. **Report** — Results
6. **Maintenance** — Heal and review

You do not have to finish Discover first. [Recording in Automate](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web) creates the actions its steps need. What Discover adds is context: [page purposes](https://docs.smartestqa.ai/en/discover-your-app.html#page-names), [notes](https://docs.smartestqa.ai/en/discover-notes.html) and the [App Map](https://docs.smartestqa.ai/en/discover-app-map.html), which the [AI features in Automate](https://docs.smartestqa.ai/en/automate-ai.html) read.

## Why build tests here

- **One control, many tests.** A step points at an action from [Discover](https://docs.smartestqa.ai/en/discover-actions.html) by its ID. Fix a locator once and every test that uses it is fixed.
- **Web, mobile, desktop, API, database, mail and messaging in one scenario.** A single test case can log in on the web, [call an API](https://docs.smartestqa.ai/en/automate-steps-api.html), [check a database row](https://docs.smartestqa.ai/en/automate-steps-database.html) and [read an OTP from a mailbox](https://docs.smartestqa.ai/en/automate-steps-mail.html#extract-otp).
- **Templates instead of copy and paste.** A login written once as a [template](https://docs.smartestqa.ai/en/automate-steps-flow.html#template) is a live reference in every test that uses it.
- **Data without code.** Steps read `{{variables}}` from [earlier steps](https://docs.smartestqa.ai/en/automate-steps-variables.html#pass-values), [data sources](https://docs.smartestqa.ai/en/data-source-variables.html) and [datasets](https://docs.smartestqa.ai/en/data-source-datasets.html); a pipeline can [run the same test once per data row](https://docs.smartestqa.ai/en/schedule-settings.html#data-loop).
- **Fast feedback.** A [dry run](https://docs.smartestqa.ai/en/automate-dry-run.html#live-log) shows every step live with a screenshot, without filling up your [reports](https://docs.smartestqa.ai/en/report.html).

## The building blocks

- **Test case:** An ordered list of steps that runs on its own and produces a [report](https://docs.smartestqa.ai/en/report.html) when a [pipeline](https://docs.smartestqa.ai/en/schedule-create.html) runs it.
- **Template:** A test case marked as a reusable block of steps. Other test cases add it as one step. Editing the template changes every test that uses it. See [Test case or template](https://docs.smartestqa.ai/en/automate-test-cases.html#case-kind).
- **Folder and module:** Folders organise the tree. Every folder directly under the project root is a **module**: it has a [twin folder in Analyze](https://docs.smartestqa.ai/en/analyze-folders.html#modules) and a [module in the App Map](https://docs.smartestqa.ai/en/discover-app-map.html#modules). See [Folders and modules](https://docs.smartestqa.ai/en/automate-test-cases.html#folders).
- **Step:** One thing the test does: [click](https://docs.smartestqa.ai/en/automate-steps-browser.html#click), [type](https://docs.smartestqa.ai/en/automate-steps-browser.html#type), [call an API](https://docs.smartestqa.ai/en/automate-steps-api.html), [assert](https://docs.smartestqa.ai/en/automate-steps-assertions.html), [run code](https://docs.smartestqa.ai/en/automate-steps-code.html), [ask the AI](https://docs.smartestqa.ai/en/automate-steps-ai.html). Most steps are bound to an **action**; templates are [steps that call another test case](https://docs.smartestqa.ai/en/automate-steps-flow.html#template).
- **Action:** A control on a page with its locators, shared across test cases. Managed in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html).
- **Parameter:** A value a step uses (the text to type, the expected result) or produces (an [output variable](https://docs.smartestqa.ai/en/automate-steps-variables.html#producers)). Shown in the right panel’s [**Parameters List**](https://docs.smartestqa.ai/en/automate-editor.html#step-parameters).
- **Variable:** A named value written as `{{name}}`. Earlier steps, [data sources](https://docs.smartestqa.ai/en/data-source-variables.html), [global parameters](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter) and [datasets](https://docs.smartestqa.ai/en/data-source-datasets.html) provide them. See [Variables and test data](https://docs.smartestqa.ai/en/automate-test-data.html).
- **Environment:** [DEV, TEST or PRP](https://docs.smartestqa.ai/en/concepts.html#environments). Each [start page URL](https://docs.smartestqa.ai/en/project-settings-project.html#start-pages) has an address per environment; the test case’s environment decides which one opens.
- **Dry run:** A trial run started from the editor, with a live log and no report. See [Dry run and live log](https://docs.smartestqa.ai/en/automate-dry-run.html).
- **Archive:** Where deleted test cases and folders go. Restoring puts them back. See [Archive and restore](https://docs.smartestqa.ai/en/automate-test-cases.html#archive).

## The screen

Automate has three panels. Click a test case in the tree to open it in the editor; the details open on the right.

![Automate: tree, editor and details.](https://docs.smartestqa.ai/media/shots/ATM-SHOT-01.png)

| Panel | What is there | Details |
| --- | --- | --- |
| Test case tree (left) | [**New Test Case**](https://docs.smartestqa.ai/en/automate-test-cases.html#create-test-case), **More** (**Create Folder**, [**New Manuel Case**](https://docs.smartestqa.ai/en/automate-test-cases.html#manual-cases), [**Generate Test Cases with AI**](https://docs.smartestqa.ai/en/automate-ai.html#generate-test-cases)), the filter, folders, test cases with their last-run icon, and the Archive at the bottom. | [Test cases and folders](https://docs.smartestqa.ai/en/automate-test-cases.html) |
| Editor (centre) | Test case or template chip, the name, **Screenshots**, [**AI Assistant**](https://docs.smartestqa.ai/en/automate-ai.html#generate-from-prompt); the step toolbar; the step list; [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) and **Save**. | [Edit steps and save](https://docs.smartestqa.ai/en/automate-editor.html), [Record and add steps](https://docs.smartestqa.ai/en/automate-add-steps.html) |
| Details (right) | [**Test Case Detail**](https://docs.smartestqa.ai/en/automate-editor.html#test-case-detail) (description, environment and start page, tags, pipelines, recent runs, requirements, history, comments) and [**Parameters List**](https://docs.smartestqa.ai/en/automate-editor.html#step-parameters) for the selected step. | [Test Case Detail](https://docs.smartestqa.ai/en/automate-editor.html#test-case-detail), [Variables and test data](https://docs.smartestqa.ai/en/automate-test-data.html) |

Click a folder instead of a test case and the editor shows the **Folder summary**: pass and fail counts, condition coverage and trust warnings. With nothing selected it shows the **Project summary**. See [Folder summary](https://docs.smartestqa.ai/en/automate-test-cases.html#folder-summary).

On screens narrower than 1200 pixels the tree becomes an overlay you open from the left rail. After a page refresh the test case you had open opens again.

## Before you start

| Project type | You need | Check it |
| --- | --- | --- |
| WEB | The [SmartestQA extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension) in Chrome or Edge for recording; a start page URL with an address for the environment you test; a test user. | The environment chip next to the start page shows your environment and is not greyed out. See [Add a start page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url). |
| MOBILE | The [agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) running on the computer with the device or [emulator and Appium Server](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#android-emulator), or a [SmartTest Device Farm](https://docs.smartestqa.ai/en/agent-pool.html) device; the app configured in [Mobile Config](https://docs.smartestqa.ai/en/project-settings-mobile.html). | The host is green in [Device Farm › Test Agents](https://docs.smartestqa.ai/en/agent-pool-agents.html#agent-list). See [Mobile and desktop apps](https://docs.smartestqa.ai/en/quick-start-connect.html#connect-mobile-desktop). |
| DESKTOP | The agent running 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 application; a [desktop application configured as default](https://docs.smartestqa.ai/en/project-settings-desktop.html#app-choice). | The [**Target Application**](https://docs.smartestqa.ai/en/automate-editor.html#test-case-detail) in Test Case Detail shows your app. |

To use the AI features, an admin turns on [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and [**AI Document Analysis**](https://docs.smartestqa.ai/en/project-settings-ai.html#what-each-switch-unlocks) in Project Panel › AI Options. See [Turn on AI](https://docs.smartestqa.ai/en/automate-ai.html#enable-ai).

## Ways to build a test case

| Method | Best when | You get |
| --- | --- | --- |
| [Record](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web) | You know the flow and can click through it | Steps and the actions they use, in the order you did them |
| [Add steps from the toolbar](https://docs.smartestqa.ai/en/automate-add-steps.html#action-list) | The [actions](https://docs.smartestqa.ai/en/discover-actions.html) exist already, or you need [API, database, mail, code or assertion steps](https://docs.smartestqa.ai/en/automate-steps.html#step-families) | Exactly the steps you choose |
| [Template](https://docs.smartestqa.ai/en/automate-add-steps.html#add-template) | A flow such as login repeats in many tests | One step that runs the whole template |
| [Generate from Prompt](https://docs.smartestqa.ai/en/automate-ai.html#generate-from-prompt) | You can describe the flow in a sentence and the actions are recorded | A full step list built from existing actions, for you to review |
| [Generate Test Cases with AI](https://docs.smartestqa.ai/en/automate-ai.html#generate-test-cases) | You want first coverage of a module quickly | A new folder with several test cases |
| [Expand Scenarios](https://docs.smartestqa.ai/en/automate-ai.html#expand-scenarios) | A happy path passes and you need negative and edge cases | 2–4 variations next to the original |
| [Analyze](https://docs.smartestqa.ai/en/analyze-import.html) | You start from requirements documents | Requirements with linked test cases |
| [AI assistant through MCP](https://docs.smartestqa.ai/en/automate-faq.html#mcp) | Developers working from source code | The assistant writes steps, dry-runs them and fixes them until green |

## How a test case runs

The same steps run in three situations. Only pipeline runs are kept.

|  | Dry run | Pipeline run |
| --- | --- | --- |
| Started from | [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) in the editor | A [pipeline in Schedule](https://docs.smartestqa.ai/en/schedule-create.html): [by hand](https://docs.smartestqa.ai/en/schedule-runs.html#run-now), [on a timer](https://docs.smartestqa.ai/en/schedule-timing.html) or [from CI](https://docs.smartestqa.ai/en/integrations-cicd.html) |
| Where it runs | On the server or your own agent | [On the server, an agent or a runner](https://docs.smartestqa.ai/en/schedule-where.html) |
| Report and last-run icon | No | Yes |
| Test data rows | First row only | One run per row when the pipeline asks for it ([data loop](https://docs.smartestqa.ai/en/schedule-settings.html#data-loop)) |

An agent is a [place where a run executes](https://docs.smartestqa.ai/en/concepts.html#where-tests-run), not a separate mode. Full comparison: [Run modes](https://docs.smartestqa.ai/en/automate-dry-run.html#run-modes).

## Best practices

#### Do

- Keep one test case to one user goal, 5 to 20 steps.
- End every test case with a proof step: an [assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html), a [visibility check](https://docs.smartestqa.ai/en/automate-steps-browser.html#visibility-check) with text, or an [API extraction](https://docs.smartestqa.ai/en/automate-steps-api.html#extract-values) you check.
- Put login and other repeated flows in [templates](https://docs.smartestqa.ai/en/automate-test-cases.html#case-kind).
- Use `{{variables}}` and [datasets](https://docs.smartestqa.ai/en/data-source-datasets.html) for data that changes.
- Dry run after every few edits; save first.
- Organise folders by business area; the top level becomes your [modules](https://docs.smartestqa.ai/en/automate-test-cases.html#modules).
- Record on TEST with a test user and test data.

#### Don’t

- Rename a step casually: it [renames the shared action](https://docs.smartestqa.ai/en/automate-editor.html#rename-step) in every test.
- Use [**Generate Steps**](https://docs.smartestqa.ai/en/automate-ai.html#generate-from-prompt) on a test case whose steps you want to keep.
- Build long chains of [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.html) where a normal action would do: they are slower and not deterministic.
- Leave [inactive steps](https://docs.smartestqa.ai/en/automate-steps-flow.html#inactive-steps) lying around for months; remove them.
- Edit the same test case with a colleague at the same time: [the last save wins](https://docs.smartestqa.ai/en/automate-editor.html#concurrent-edits).
- Type real passwords into step values; use a [data source](https://docs.smartestqa.ai/en/data-source-secrets.html).

## In this section

The step types themselves, with every parameter, are described in the [step reference](https://docs.smartestqa.ai/en/automate-steps.html).

- [Test cases and folders](https://docs.smartestqa.ai/en/automate-test-cases.html) — Create test cases and templates, organise them in folders and modules, find them, and archive or restore them.
- [Record and add steps](https://docs.smartestqa.ai/en/automate-add-steps.html) — Record a flow in a web, mobile or desktop app, or add steps one by one from the toolbar, including templates.
- [Edit steps and save](https://docs.smartestqa.ai/en/automate-editor.html) — The editor screen, reordering and switching steps off, replacing and editing actions, Test Case Detail, and what Save checks.
- [Variables and test data](https://docs.smartestqa.ai/en/automate-test-data.html) — Write {{variables}}, pass values between steps, use data sources and datasets, and run one test case once per data row.
- [Dry run and live log](https://docs.smartestqa.ai/en/automate-dry-run.html) — Start a dry run on the server, your agent or a device, read the live log, and see how a dry run differs from a pipeline run.
- [AI in Automate](https://docs.smartestqa.ai/en/automate-ai.html) — Generate steps from a prompt, expand a case into negative and edge cases, generate test cases for a module, AI descriptions, AI steps and AI Analyze.
- [How the numbers work](https://docs.smartestqa.ai/en/automate-numbers.html) — Formulas and worked examples for the status icon, template badge, usage chip, folder summary, live-log progress and recent runs.
- [Troubleshooting](https://docs.smartestqa.ai/en/automate-troubleshooting.html) — Every Automate message and symptom, with why it happens, what to check and how to fix it.
- [FAQ, MCP & limits](https://docs.smartestqa.ai/en/automate-faq.html) — Questions and answers, how AI assistants build test cases through MCP, and the module’s limits.

## Related

- [Actions](https://docs.smartestqa.ai/en/discover-actions.html): the controls and locators that steps point at.
- [Link test cases](https://docs.smartestqa.ai/en/analyze-test-cases.html): connect test cases to requirements in Analyze.
- [Data Source](https://docs.smartestqa.ai/en/data-source.html): keys, datasets and connections that steps read.
- [Build a pipeline](https://docs.smartestqa.ai/en/schedule-create.html): run test cases on demand or on a schedule.
- [Report](https://docs.smartestqa.ai/en/report.html): results of pipeline runs.
- [Auto-heal reviews](https://docs.smartestqa.ai/en/maintenance-auto-heal.html): repaired locators to approve.
