---
title: "Edit steps and save"
section: "Automate"
description: "The SmartestQA test case editor: reorder, deactivate, remove and replace steps, edit shared actions safely, fill Test Case Detail and save."
url: https://docs.smartestqa.ai/en/automate-editor.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "test case editor step list reorder drag activate deactivate remove replace action action detail edit action save as copy rename step shared action test case detail environment start page url tags pipelines recent runs requirements history comments save unsaved changes parameters changed"
---
# Automate: Edit steps and save

The editor in the centre of Automate holds the steps of one test case; the right panel holds its details and the selected step’s values. This page covers changing steps, the Test Case Detail panel, and what happens when you save.

## In short

**On this page you can**

- Reorder steps by dragging, and switch them off with Deactivate .
- Swap a step’s control with Replace Action .
- Fix a shared action’s locators with Action Detail .
- Set environment, start page, tags and requirement links in Test Case Detail .
- Save, and keep pipelines in sync when parameters change.

**How to use it**

1. Click a step to open its values in Parameters List .
2. Change values, order or active state of the steps you need.
3. Click Save and fix any issue it lists.
4. If asked, update the pipelines that use the test case.
5. Run a Dry Run to check the change.

## The editor

![The editor with one inactive step.](https://docs.smartestqa.ai/media/shots/ATM-SHOT-04.png)

| Area | What you find |
| --- | --- |
| Header | The kind chip (**Test case** or **Template**, see [Test case or template](https://docs.smartestqa.ai/en/automate-test-cases.html#case-kind)); the name; **Screenshots** (only when a step has a screenshot); [**AI Assistant**](https://docs.smartestqa.ai/en/automate-ai.html#generate-from-prompt) (see [AI in Automate](https://docs.smartestqa.ai/en/automate-ai.html)); **Tags** when the right panel is not pinned. |
| Step toolbar | **Record** and the step types. See [The step toolbar](https://docs.smartestqa.ai/en/automate-add-steps.html#toolbar). |
| Step list | One row per step: order number, [type chip](https://docs.smartestqa.ai/en/automate-steps.html#step-families) (Click, Type, Get, Verify, API…), step name and the step’s menu. A step you added but have not saved yet is marked “This step has not been saved yet”. An empty list says “No steps yet” and “Use the toolbar above to add steps”. |
| Bottom | [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) and **Save**. There is no autosave and no keyboard shortcut for Save. |
| Right panel | **Test Case Detail** and **Parameters List** ([**DB Requests**](https://docs.smartestqa.ai/en/automate-steps-database.html#add-db-step) when a database step is selected). It opens as a drawer; pin it to keep it open. The choice is remembered in your browser. |

## Change steps

### Reorder

Drag a step row up or down (“Drag to reorder”). The steps are renumbered 1 to *n*. Steps run in that order. The new order is kept when you click **Save**.

### Switch a step off and on

Open the step’s ⋮ menu and click **Deactivate**. The step stays in its place, greyed out, and is left out of every run: [dry runs](https://docs.smartestqa.ai/en/automate-dry-run.html#what-runs) and [pipelines](https://docs.smartestqa.ai/en/schedule-create.html). **Activate** brings it back. The change is kept when you click **Save**.

Use it to switch off a step while you investigate. A deactivated [template step skips the whole template](https://docs.smartestqa.ai/en/automate-steps-flow.html#inactive-steps). Remove steps you no longer need instead of keeping them inactive for long: inactive steps confuse the next reader.

### Remove

⋮ › **Remove** removes the step from the list at once, without asking (“*name* step removed”). Nothing changes on the server until you click **Save**; to undo, leave without saving. When you save, steps that brought their own action ([code](https://docs.smartestqa.ai/en/automate-steps-code.html), [AI](https://docs.smartestqa.ai/en/automate-steps-ai.html), [API](https://docs.smartestqa.ai/en/automate-steps-api.html), [database](https://docs.smartestqa.ai/en/automate-steps-database.html)) are cleaned up with them. The action of an ordinary step stays in [Discover](https://docs.smartestqa.ai/en/discover-actions.html) for other tests.

### Replace the action

Click **Replace Action** (⇄) on a step to bind it to another [action](https://docs.smartestqa.ai/en/discover-actions.html#action-list), for example when the button you click was redesigned. The step keeps its place, but its values are reset to empty: fill them in again before you save.

### Edit the action behind a step

Click **Action Detail** (⚡) on a step to see the action it uses, with its [locators and screenshot](https://docs.smartestqa.ai/en/discover-actions.html#manual-action). **Edit Action** opens the action form.

- **Save** in the action form writes the action at once (“Action update success”). It changes the action for **every** test case that uses it, without the test case’s own **Save**.
- **Save as Copy** is for changing the action of this test case only. It becomes available after you change the action. It “Removes the selected step, creates a copy at the same order with new action values, and adds it as a new test step.” It is not available for assertion, JMeter, k6, AI, API, database and global parameter steps: “Save as copy is not supported for Assertion, JMeter, API, and AI action types.”

> **Warning: Check the usage chip before you edit**
>
> When you select a step, the right panel shows “This action is used in *n* test cases”. Amber means more than one. Click it to see which. If the number is high, prefer **Save as Copy** for a change that only this test needs. See [Usage chip](https://docs.smartestqa.ai/en/automate-numbers.html#usage-chip).

### Rename a step

Select the step and change **Test Step Name** in the right panel (up to 255 characters). A step’s name is the name of its action, so when you click **Save** the action is [renamed in Discover](https://docs.smartestqa.ai/en/discover-actions.html#rename) and in every test case that uses it. No warning is shown. Steps keep working: they point at the action by ID, not by name.

### Step values (Parameters List)

Select a step to see its values in **Parameters List**: the text to type, the option to select, the expected value, the variable a step produces. Click **Add Param** to add one more row (“Add new parameter to step”). The [data picker icon](https://docs.smartestqa.ai/en/data-source-in-tests.html#picker) next to a value (“Data Sources - Global Parameters - Datasets”) inserts a `{{variable}}` instead of a fixed value. How variables work: [Variables and test data](https://docs.smartestqa.ai/en/automate-test-data.html). The parameters of each step type: [step reference](https://docs.smartestqa.ai/en/automate-steps.html).

Not available: duplicating a step (other than **Save as Copy**), grouping steps (use a [template](https://docs.smartestqa.ai/en/automate-add-steps.html#add-template)), and notes on single steps.

## Test Case Detail

![The Test Case Detail panel.](https://docs.smartestqa.ai/media/shots/ATM-SHOT-05.png)

| Field | What it is |
| --- | --- |
| [**Description (written by AI)**](https://docs.smartestqa.ai/en/automate-ai.html#ai-descriptions) | Read only. “AI writes what this test case verifies, from its steps.” Until the AI has written it, it copies the name you type. See [AI descriptions](https://docs.smartestqa.ai/en/automate-ai.html#ai-descriptions). |
| Environment and start page (WEB) | The environment chip and the start page URL the test opens first. See below. |
| **Target Application** (DESKTOP) | The desktop application the test drives. Empty means the [project’s default](https://docs.smartestqa.ai/en/project-settings-desktop.html#app-choice). MOBILE projects have no start page: the app comes from [Mobile Config](https://docs.smartestqa.ai/en/project-settings-mobile.html). |
| **Tags** | Labels you can filter the tree by (**Filter By Tags**). Saved at once; “No tags yet” when empty. |
| **Pipelines** | “Pipelines that run this test case. Click one to open it.” Empty: “Not in any pipeline yet.” |
| **Recent runs** | The last pipeline runs of this test case; click one to open its [report](https://docs.smartestqa.ai/en/report-summary.html). [Dry runs are not listed](https://docs.smartestqa.ai/en/automate-dry-run.html#run-modes). Empty: “Not run yet.” |
| **Connected Requirements** | The [requirements from Analyze](https://docs.smartestqa.ai/en/analyze-test-cases.html#link-existing) this test case covers. [**Add Requirement**](https://docs.smartestqa.ai/en/analyze-test-cases.html#link-existing) links one; the link is kept when you click **Save**. |
| **History** | “Changes to this test case: who, when and from where.” |
| **Comments** | Notes for your team. Saved at once. |
| Footer | `#id`, **Created by** and **Updated by**. |

### Environment and start page (web)

A start page URL is a named address with one value per [environment](https://docs.smartestqa.ai/en/concepts.html#environments): DEV, TEST and PRP. The test case stores both the start page and the environment; together they decide which address opens. Start page URLs are managed in [Project Panel](https://docs.smartestqa.ai/en/project-settings-project.html#start-pages); see [Add a start page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url).

- Click the environment chip to choose DEV, TEST or PRP. Environments with no address for this start page are disabled: “No URL defined for this environment”.
- When you pick another start page, the environment switches to one that has an address, preferring TEST, then DEV, then PRP.
- A start page you just picked is stored with the test case when you click **Save**: “This URL has not been saved yet. It will be saved when you click Save.”
- New test cases start on the environment you used last in this browser, otherwise TEST.

> **Warning: PRP is the production-side environment**
>
> A test case on PRP clicks, types and submits in that system. Keep PRP for read-only checks unless you mean it.

## Save

Click **Save**. It is disabled while the name is empty (“Enter a test case name at the top to enable Save”). Save checks, in this order:

| # | Check | Message |
| --- | --- | --- |
| 1 | A web test case has a start page URL | “Please select a Start Page URL.” The URL dialog opens; Save runs again after you pick one. |
| 2 | Name, description, and for web start page and environment, are filled | “Please fill the following fields:” followed by the missing ones (Test Case Name, Description, Start Page Url, Environment) |
| 3 | Every step’s required values are valid | “Cannot save yet” and “*n* issue(s) found”, with up to five lines `"Step" → field: message` |
| 4 | A [step timeout](https://docs.smartestqa.ai/en/automate-steps-flow.html#timeouts) is between 1 and 300 seconds | `"<step>" → Timeout: 1-300 sn` |
| 5 | No step has the same parameter key twice | “Duplicate keys found in step:” with the step and keys |
| 6 | Names that [create variables](https://docs.smartestqa.ai/en/automate-test-data.html#produce-variables) are unique in the test case | “Names that produce a global parameter must be unique within the test case. Conflicts:” with the names |

Then the server saves. Success shows “*name* updated successfully”. A key that clashes with an existing [global parameter](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter) shows “This key is already registered as a global parameter, please change the key value.” Every other server-side refusal shows “Test case not be updated”; see [what it can mean](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-case-not-updated).

### When parameters change: Test Case Parameters Changed

Pipelines keep their own copy of each test case’s [parameter values](https://docs.smartestqa.ai/en/schedule-settings.html#pipeline-parameters). If you add, remove or change parameters of a test case that is in one or more pipelines, Save opens **Test Case Parameters Changed**.

1. **Select the pipelines**

   The dialog lists the pipelines that use the test case. “The selected schedulers are synced to this test case: new parameters are added and removed ones are deleted.”
2. **Decide about values**

   Tick **Update parameter values from the test case** to overwrite the pipelines’ values with the test case’s. Leave it unticked to keep the pipelines’ values (“Your scheduler values are kept — only added or removed parameters are synced.”).
3. **Update**

   Click **Update**.

   “*n* scheduler(s) updated. Added: *a*, Deleted: *d*”.

Renaming a key alone does not open the dialog. If you skip the dialog, pipelines keep running with their old parameter list.

### What is saved without Save

| Change | Saved |
| --- | --- |
| Steps [recorded with the web extension](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web) | At once, while recording |
| **Edit Action** in Action Detail, **Save as Copy** | At once, for every test case that uses the action |
| Name and page of a saved [AI step](https://docs.smartestqa.ai/en/automate-steps-ai.html) | At once |
| Tags and comments | At once |
| Everything else: steps, order, active state, values, name, kind, environment, start page, [requirement links](https://docs.smartestqa.ai/en/analyze-test-cases.html) | When you click **Save** |

### Leaving with unsaved changes

If you open another test case or leave Automate with unsaved changes, you are asked “Are you sure to exit without saving?” with **Exit without saving**, **Cancel** and **Save and Exit**. Refreshing or closing the tab shows the browser’s own warning. [**Dry Run**](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) stays disabled until you save (“Please save the test case before running”).

### Two people editing the same test case

Test cases are not locked. If two people edit the same test case, the last **Save** wins, and steps the other person added can disappear. Agree who edits which test case, and reopen a case before you change it if a colleague may have worked on it.

## If something goes wrong

- [Save is disabled](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-save-disabled)
- [“Please fill the following fields: … Description”](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-fill-fields)
- [“Cannot save yet — n issue(s) found”](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-cannot-save-yet)
- [“Test case not be updated”](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-case-not-updated)
- [A rename or locator change showed up in other test cases](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-renamed-everywhere)
- [Replace Action cleared my values](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-replace-cleared)
- [Steps disappeared after a colleague saved](https://docs.smartestqa.ai/en/automate-troubleshooting.html#fix-steps-disappeared)
