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

# Editing tests

### Adding steps

To add a new Step at the end of your test, click on a <img src="/files/sJ3PNPu4aj8LUr2MTku8" alt="" data-size="line"> button either on the top or the bottom panel.

### Adding steps between other steps

Once you have at least two steps in your Scenario you can use <img src="/files/3LJ3TAl6RMEJBucRrM4k" alt="" data-size="line"> buttons to add steps between existing ones in any position you need.

### Copying steps

Next to the "Add step in-between" button there's a "Copy" icon <img src="/files/sZslLZCeLuhGvfKRx8AD" alt="" data-size="line"> that allows you to duplicate the step above.

### Reordering steps

To change the position of a Step in a test, you can use the <img src="/files/4MX6dq95TYAGoJ40SRcc" alt="" data-size="line"> icon on the left side of a Step to drag'n'drop it over to the position you need.

### Deleting steps

To delete a Step, click on its <img src="/files/9tppeX7YC2peT9T6Nbfc" alt="" data-size="line"> button located on the far right side after a Step value.&#x20;

### Screenshots

Every Step has a Screenshot Toggle <img src="/files/IyCvc3AqwNNdTSWLhOHm" alt="" data-size="line"> next to it. You can choose at which steps you want DogQ to capture screenshots and store page source code when you run the test.&#x20;

{% hint style="info" %}
Screenshots and source code are stored for a **year**, unless you delete the test, and can be viewed in a Test Run Report.&#x20;
{% endhint %}

### Step description

To add a comment to a Step, click on the Description Toggle <img src="/files/s9brpxYtNPJ09nGvet1Z" alt="" data-size="line"> next to it. Doing so will expand an area below the Step where you can add a meaningful description and format it to your liking.&#x20;

<figure><img src="/files/dKGWg0WeWskIUUhHLeWZ" alt=""><figcaption></figcaption></figure>

### Scenario description

Each Scenario you create can be given a description or a comment. To do so, open the Scenario in the Test Editor and click on the Edit icon <img src="/files/7xx6VMaJ1Xj6LlMXY1sp" alt="" data-size="line">in the dedicated area of the header.

<figure><img src="/files/G8hRIM8WuAFmlzEBBVK2" alt="" width="375"><figcaption></figcaption></figure>

### AI Step generator

This <img src="/files/iBWVjCPn5hJyVdIZkGlp" alt="" data-size="line"> button can only be seen on the last step of the test. Clicking it will open a modal window where you can tell AI assistant what to do in a natural manner. DogQ will run the test as is, get to the page it needs to interact with and generate new steps according to your prompt. For more details, visit [AI Step generator](#ai-step-generator).

<figure><img src="/files/pPHBA8vBXv3k6MPCAnok" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dogq.io/documentation/editing-tests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
