Skip to main content

Create Groups and Tests

Use groups to organize tests by the part of your app they cover, such as Accounts, Billing, or Checkout. Groups can contain nested groups.

Create a group​

  1. Open Tests.
  2. Open Test options (… beside search) and choose New folder, or use a group's menu to add a nested folder.
  3. Enter a short name and confirm.

Create a test​

  1. Choose New test above the test tree. A group's menu also offers New test feature.
  2. Check Test folder in the dialog. You can search for and select the destination before creating, describing, recording, or importing the test.
  3. Choose Markdown test to write steps in plain language, or Gherkin test for Given, When, and Then.
  4. Name the test, write its steps and expected results, and choose Save.

The same New test dialog also offers Describe with the Assistant, Record browser, Import issue, and Import document. Importing an issue requires a connected issue tracker.

Use a name that describes the outcome, such as “Customer downloads an invoice PDF.” A test should have enough setup to run independently.

Organize existing tests​

Open an item's … menu to rename, duplicate, move, or delete it. Move to group changes its place in the tree. Review the confirmation before deleting a group and its contents.

Group and test names contribute to exported file paths. Check any external references after reorganizing synced test files.

Shared setup​

Use a Gherkin Background for setup repeated by every scenario in one feature. Selecting several tests does not make them share a signed-in browser session or guarantee execution order. See Shared setup and dependencies.

Next: Write good test instructions.