> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/platform/scenario-editor.md).

# Scenario editor

The **Scenario editor** turns each [Test Step](/getting-started/terminology.md) into a plain-language sentence. New [Flows](/getting-started/terminology.md) open here so you can get a first success without learning the canvas first.

The Scenario editor and the [Flow Builder](/platform/flow-builder.md) share the same Test Steps. Switching tabs does not start a new Flow.

![Scenario editor with a short first Flow](/files/6CJsRZzsnT6Q9SbNbwtc)

## What you can do here

* Read and edit steps as sentences, such as Open, Touch, and Check
* Change Values and Element names by clicking parts of the sentence
* Add the next step with **What's the next test step?**
* Reorder steps in the list
* Run or preview the Flow from the toolbar
* Switch to the **Flow** tab to see the same steps in the Flow Builder

## Open the Scenario editor

{% stepper %}
{% step %}

## Open or create a Flow

Open a Flow from **Flows**, or create a Flow.
{% endstep %}

{% step %}

## Stay on the Scenario tab

Stay on the **Scenario** tab. That is the default for a new Flow.

The Scenario tab stays available while the Flow is a single path. When you add Flow Branches in the Flow Builder, continue editing on the **Flow** tab. See [Choose Flow Branch shapes](/better-coverage/choose-flow-branch-shapes.md).
{% endstep %}
{% endstepper %}

## Edit a sentence

1. Click the part of the sentence you want to change, such as a URL, Element name, or Value.
2. Choose or type the new value.
3. Changes save as you work.

Use **What's the next test step?** at the end of the list to add the next step. The picker suggests steps that fit the sentence you are building.

## Run from the Scenario editor

Use the toolbar to run or preview the Flow while you edit. Results open the same way as from the Flow Builder. See [Understand your results](/getting-started/understand-your-results.md).

## When to prefer the Scenario editor

| Prefer the Scenario editor when                  | Prefer the Flow Builder when                       |
| ------------------------------------------------ | -------------------------------------------------- |
| You want a single path written as sentences      | You need Flow Branches or a multi-path design      |
| You are new to DoesQA                            | You are rearranging a larger Flow on the canvas    |
| You are editing step wording quickly             | You want the full step library laid out visually   |
| You are changing Values and Element names inline | You need Step Groups, align, or multi-select tools |

For a first walkthrough that starts here and continues in the Flow Builder, see [Create and run your first Flow](/getting-started/create-and-run-your-first-flow.md).

{% hint style="info" %}
**Pro tip:** Build the happy path as sentences first. Switch to the Flow Builder when you want branches, Step Groups, or a clearer layout of a longer Flow.
{% endhint %}

## Related

* [Flow Builder](/platform/flow-builder.md)
* [Choose Flow Branch shapes](/better-coverage/choose-flow-branch-shapes.md)
* [DoesQA AI](/platform/doesqa-ai.md)
* [Create and run your first Flow](/getting-started/create-and-run-your-first-flow.md)
* [DoesQA concepts](/getting-started/doesqa-concepts.md)
* [Terminology](/getting-started/terminology.md)