Run your first web test

This guide gets you from zero to a passing test in under five minutes.

Prerequisites

Step 1: Create a workspace

Sign in to Traceback and create a new workspace. Give it a name that matches your project.

Step 2: Write your first test

From the Tests tab, click + New Test. You’ll see the test editor.

Write your test in plain English:

Go to https://your-app.com
Sign in with user@example.com and the password test1234
Verify that the dashboard loads and the user's name appears in the header
Tip

Good tests describe what the user does, not how the browser does it. Avoid referencing CSS selectors or specific DOM elements.

Step 3: Run the test

Click Run a test. Traceback will open a browser session and execute your test in real time. You can watch it live in the Runs tab.

Step 4: Review results

Once the run finishes, you’ll see:

  • Pass — all steps succeeded ✓
  • Fail — at least one step failed, with a screenshot and log attached
  • Issues — if any failure was auto-triaged, an Issue is created
Note

The first run often fails due to timing or auth setup. This is normal — review the failure screenshot, adjust your prompt, and rerun.

Step 5: Save and schedule

Once the test passes, click Save. You can now:

  • Add it to a Suite for batch runs
  • Enable PR checks so it runs on every pull request
  • Set a schedule for recurring regression testing