Skip to main content
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.
1

Create New Product

Click ”+ New Product” in the top navigation
2

Fill in Details

Enter the following information:
  • Name: My First App
  • Description: Testing my web application
  • Type: Web Application
3

Save

Click “Create Product”
Create Product Demo
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!
Create Test Case Demo
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.
1

Go to Test Management

Navigate to the Test Management page
2

Find Your Test

Locate your test case (TC-0001)
3

Start Run

Click the ”▶ Run” button
4

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
5

Execute

Click “Start Run”
Create Test 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:
  1. Perform the action (e.g., navigate to login page)
  2. Observe the result
  3. 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
  4. 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

MetricValue
Total Tests1
Passed0
Failed1
Blocked0
Pass Rate0%
Duration8 minutes
Complete Test Run

​
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

Unlimited! Create as many as you need to properly test your application.
Manual tests record human execution. For automation, integrate with tools like Selenium or Playwright (coming soon).
Yes! Use the AI to convert existing test documentation:
Create tests from this document: [paste your test doc]
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! 🚀