Skip to content

Edit Test Steps

Open a test and click Edit. The editor gives you three tabs, and the one you pick decides how you work with the steps.

TabWhat you get
MarkdownThe raw description. Full control over tables, headings, and images
Rich editorEach step and its expected result in its own field. No Markdown to write
PreviewThe finished test as a tester sees it

Both tabs edit the same description, so you can switch between them at any time.

Markdown and Rich editor both edit the same test description

  1. On the Tests page, open a test.
  2. Click Edit.
  3. Open the Rich editor tab.
  4. Change the text of any step or its expected result.
  5. To add a step, click Add new step.
  6. Click Save.

The Rich editor with a step and its expected result in separate fields

Your changes are saved to the test description and appear under Steps on the test page.

Each field has its own formatting buttons - bold, italic, code, and a link. The expected result also takes an image.

Step data is a note on the step. Use it for extra context the tester needs, such as the account to sign in with or the values to enter.

  1. Click Step data under the step.
  2. Enter the note.

The field takes formatting and images, like the others.

To hide the Step data or Expected result field, click the × next to its name.

  1. Click the handle next to the step number.
  2. Choose Delete.

The step handle menu open with the Delete option

Add Steps in the toolbar is different from Add new step. It offers the steps already in your project, so you pick one instead of typing it again. See Steps Database.

  • No steps in the Rich editor. The test has no ## Steps section yet. Add one in the Markdown tab — see Test Steps and Expected Results.
  • The formatting changed after saving. The Rich editor rewrites steps in its own format. If the test used a table, subheadings, or a separate ## Expected Results section, edit it in the Markdown tab instead.