Steps

steps is a list. Each item is one of three kinds:

KindFormWhat happens
Actiona plain-English stringThe platform finds the element or action the sentence describes on the live page and performs it.
Assertionassert: <plain English>The platform checks that the sentence is true for the current page. A false assertion fails the test.
API callapi: blockSee API steps (Beta).

Actions

tests/login.test.yaml
1name: Log in with email2url: https://staging.example.com3steps:4  - Click "Log in"5  - Type EMAIL into the email field6  - Type PASSWORD into the password field7  - Click "Continue"8  - assert: The dashboard shows the account name

Write one action per step. Quote visible text exactly when it identifies the element, as in Click "Continue".

Assertions

An assertion states what should be true. The platform does not add assertions you did not write. A test with no assert: step passes when every action completes.

What steps are not

A spec needs step structure. Free-form prose without a list of steps is not accepted.