Quickstart

Create, Run, and Review Your First Automated Test

This quickstart guide walks you through the core TestFirst workflow—from defining what to test to running your first automated test.

Before you begin, you’ll need a TestFirst account.

Sign up using your email or Google account. Once you’re signed in, you can start testing immediately.

You don’t need prior QA experience. If you can describe how a feature works, TestFirst helps you turn that knowledge into structured tests.

What You’ll Achieve

By the end of this guide, you will have:

• Created a Test Scope

• Generated AI-assisted test cases

• Completed a test using the Recorder

• Run a test

• Viewed the test results

The Big Picture

Requirement / Specification
   ↓
Test Scope
   ↓
AI-generated Test Cases
   ↓
Automate Test Case
   ↓
Run Test
   ↓
View Results

This workflow helps you move from product knowledge to test coverage quickly.

Step 1: Create Your First Test Scope

A Test Scope defines what you want to test. It typically represents a feature, module, or release.

Examples include:

• Login functionality

• Checkout flow

• A new feature

• Regression testing for a release

Create a Test Scope

1. Open Test Scopes from the sidebar

2. Click + New Test Scope

3. Enter a scope title (optional) If left empty, TestFirst generates one automatically.

4. Upload a requirement or design document Supported formats include TXT, Markdown, DOCX, and PDF. You can also use the demo file to get started quickly.

5. Click Create

🌟 Your Test Scope is now ready.

---

Step 2: Generate Test Cases

Once your scope is created, TestFirst can generate draft test cases automatically.

Generate test cases

1. Click Generate Test Cases

2. TestFirst analyzes your uploaded documents

3. Draft test cases are generated automatically

You may see two types of suggestions:

• AI-generated test cases based on your documents

• Recommended tests from your Test Library (if available)

Review and select tests

1. Review the generated test cases

2. Select the ones you want to include

3. Click Add

These tests are now part of your Test Scope.

---

Step 3: Open the Test Case in the Editor and Complete the Test Case

Before tests can be executed, each test case must be completed.

Completing a test case means either:

• Automating it, or

• Writing the steps manually using the TestFirst Editor

Recommended: Use the Recorder

The Recorder is the fastest way to create automated tests.

1. In your Test Scope, click the Edit icon on a test case

2. The test case opens in the TestFirst Editor

3. Click Recorder

4. Download and install the Utilities Pack if prompted, and run the Test Runner

5. Enter the website URL

6. Record the test by performing actions such as:

   • Clicking elements

   • Typing input

   • Verifying page content

7. Set the test case status to Ready for Testing

8. Save the test case

Your automated test is now ready 🎉

---

Step 4: Run the Test

Back in your Test Scope:

1. Refresh the page, then click Run Test

2. Select the test cases to execute

3. Click Run

What happens automatically

• A Test Plan is created

• The test plan is sent for execution

• The run appears under Last Test Runs

---

Step 5: View Test Results

To see results:

• Click the Test Run link in your Test Scope

From there, you can:

• See pass/fail status

• Open execution details

• Review screenshots and logs

• Generate reports

---

You’re Done! 🎉

You’ve just completed the full TestFirst workflow:

✔ Defined what to test ✔ Generated test cases ✔ Automated a test ✔ Executed the test ✔ Viewed the results

You now have a working automated test in TestFirst.

---

What to Do Next

Continue exploring TestFirst:

• Add more test cases to the same scope

• Create a new scope for another feature

• Explore your Test Case Library organization

• Generate reports from Test Runs