Skip to main content

Create Your First Test

Choose one small behavior with an observable result. You can write it yourself or ask the Assistant for a first draft.

Pick the group the test belongs in, start from a Gherkin test, and write one self-contained scenario — signing itself in with credentials inserted from the project's variables rather than hardcoded, then saving into that group.

Create a Gherkin test​

  1. Open Tests and choose New test.
  2. Check Test folder and select where the test belongs.
  3. Select Gherkin test.
  4. Name the test and write the steps, using the labels that appear in your app.
  5. Choose Save.

For example, adapt this to your app's actual labels and starting page:

Feature: Sign in

  Scenario: User signs in with a test account
    Given I am on the "Sign in" page
    When I enter "{{var:USERNAME}}" in the "Email" field
    And I enter "{{secret:PASSWORD}}" in the "Password" field
    And I click "Sign in"
    Then the "Dashboard" heading should be visible

Add USERNAME and PASSWORD in Settings → Variables & Secrets before running or generating this example. The editor displays their references as chips and keeps the underlying token syntax.

Other starting points​

Choose Markdown test for plain-language steps and expected results. Describe with the Assistant drafts from a description and can use attached screenshots. You can also record a browser journey or import existing material.

Review drafts before using them: make the starting page, data, actions, and expected outcome explicit. Keep setup self-contained and avoid combining unrelated flows.

Next: Generate Playwright code.