Quick Start Guide

Get up and running with OneTest in under 5 minutes. This guide will walk you through creating your first test, running it, and viewing results.

Prerequisites

Before you begin, make sure you have:

A OneTest account (Sign up here)

Access to the OneTest web application

Basic understanding of software testing concepts

If you’re new to testing, check out What is OneTest? first for a gentle introduction.

Step 1: Create Your First Product

A product is a workspace that contains all your tests, test runs, and settings.

Create New Product

Click ”+ New Product” in the top navigation

Fill in Details

Enter the following information:

Name: My First App
Description: Testing my web application
Type: Web Application

Save

Click “Create Product”

You can create multiple products for different applications or teams.

Step 2: Create Your First Test Case

Now let’s create a simple test case. We’ll use the AI Assistant to make it quick!

Using AI (Recommended)
Manual Creation

Open AI Chat

Press Cmd/Ctrl + K to open the chat

Ask AI to Create Test

Type:

Create a test for login with valid credentials

Review Generated Test

Watch the AI create your test automatically

Save

Click “Save” when you’re happy with it

Example AI Output:

✅ Created TC-0001: Verify successful login with valid credentials

Title: Verify successful login with valid credentials
Type: Manual
Priority: P2
Tags: smoke, login, authentication

Preconditions:
- User has a valid account
- User is not already logged in

Test Steps:
1. Navigate to the login page
   Expected: Login form is displayed with username and password fields

2. Enter valid username: test@example.com
   Expected: Username field accepts the input

3. Enter valid password
   Expected: Password is masked with dots (••••)

4. Click the "Login" button
   Expected: User is redirected to the dashboard within 2 seconds

5. Verify user name is displayed in the header
   Expected: Header shows "Welcome, Test User"

Pass Criteria:
- User successfully logs in without errors
- Dashboard loads within 2 seconds
- User session is created

AI-generated tests are usually more detailed and follow best practices automatically!

Navigate to Test Management

Go to the Test Management page

Create New Test

Click ”+ New Test Case” button

Fill Basic Info

Title: Verify successful login with valid credentials
Type: Manual
Priority: P2
Tags: Add smoke and login

Add Test Steps

For each step:

Click ”+ Add Step”
Enter Action: (e.g., Navigate to login page)
Enter Expected Result: (e.g., Login form is displayed)

Save

Click “Save Test Case”

Your test case is automatically assigned a unique identifier (e.g., TC-0001) and is now ready to be executed!

Step 3: Run Your First Test

Now let’s execute the test case you just created.

Go to Test Management

Navigate to the Test Management page

Find Your Test

Locate your test case (TC-0001)

Start Run

Click the ”▶ Run” button

Configure Run

In the dialog, enter:

Run Name: First Test Run - Staging
Environment: Select Staging (or create one)
Build: Select a build or leave empty

Execute

Click “Start Run”

Step 4: Execute and Record Results

OneTest will take you to the Test Execution page where you can record your results as you test.

Recording Results

For each test step:

Perform the action (e.g., navigate to login page)
Observe the result
Click the status:
- ✅ Pass - Everything works as expected
- ❌ Fail - Something doesn’t match the expected result
- ⏭️ Skip - Step wasn’t executed
- 🚫 Blocked - Can’t proceed due to an issue
Add notes if needed (especially for failures!)

Example Execution

Step 1: Navigate to login page
Status: ✅ Pass
Notes: Login form loaded correctly

Step 2: Enter valid username
Status: ✅ Pass

Step 3: Enter valid password
Status: ✅ Pass
Notes: Password was properly masked

Step 4: Click Login button
Status: ❌ Fail
Notes: Got error "Server timeout" - dashboard didn't load

Step 5: Verify user name
Status: 🚫 Blocked
Notes: Could not complete due to step 4 failure

When done, click “Complete Execution”.

Step 5: View Your Results

After completing the test run, you’ll see a summary:

Run Summary

Metric	Value
Total Tests	1
Passed	0
Failed	1
Blocked	0
Pass Rate	0%
Duration	8 minutes

What’s Next?

Tests Passed

Continue creating more test cases
Build a smoke test suite
Set up automated runs

Tests Failed

Review failure notes
Report bugs to your team
Retest after fixes

Next Steps

Congratulations! You’ve created and run your first test. Now you can:

Generate Tests with AI

Create tests faster with AI assistance

Organize Tests

Use folders and tags effectively

Learn OQL

Search tests with powerful queries

Set Up Environments

Configure staging and production

Plan Releases

Manage releases and sprints

Invite Team

Collaborate with your team

Common Questions

How many test cases can I create?

Unlimited! Create as many as you need to properly test your application.

Can I automate test execution?

Manual tests record human execution. For automation, integrate with tools like Selenium or Playwright (coming soon).

Can I import existing tests?

Yes! Use the AI to convert existing test documentation:

Create tests from this document: [paste your test doc]

How do I organize many tests?

Use folders for hierarchy and tags for cross-cutting concerns:

Folders: By feature (Login, Checkout, Profile)
Tags: By type (smoke, regression, api)

→ Learn more about organizing tests

Need Help?

Ask the AI

Press Cmd/Ctrl + K and ask anything

Community Support

Join the community discussions

Report Issues

Found a bug? Let us know

Email Support

Get help from our team

Ready to level up?

Try generating multiple tests with AI next! 🚀

Get Started

Using OneTest

Settings

Resources

Quick Start Guide

Prerequisites

Step 1: Create Your First Product

Step 2: Create Your First Test Case

Step 3: Run Your First Test

Step 4: Execute and Record Results

Recording Results

Example Execution

Step 5: View Your Results

Run Summary

What’s Next?

Tests Passed

Tests Failed

Next Steps

Generate Tests with AI

Organize Tests

Learn OQL

Set Up Environments

Plan Releases

Invite Team

Common Questions

Need Help?

Ask the AI

Community Support

Report Issues

Email Support

Ready to level up?

​Prerequisites

​Step 1: Create Your First Product

​Step 2: Create Your First Test Case

​Step 3: Run Your First Test

​Step 4: Execute and Record Results

​Recording Results

​Example Execution

​Step 5: View Your Results

​Run Summary

​What’s Next?

Tests Passed

Tests Failed

​Next Steps

Generate Tests with AI

Organize Tests

Learn OQL

Set Up Environments

Plan Releases

Invite Team

​Common Questions

​Need Help?

Ask the AI

Community Support

Report Issues

Email Support

Ready to level up?

Prerequisites

Step 1: Create Your First Product

Step 2: Create Your First Test Case

Step 3: Run Your First Test

Step 4: Execute and Record Results

Recording Results

Example Execution

Step 5: View Your Results

Run Summary

What’s Next?

Next Steps

Common Questions

Need Help?