> ## Documentation Index
> Fetch the complete documentation index at: https://onetest.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Your First Test

> Create your first test case in OneTest in about 2 minutes

Let's create your first test case in OneTest. This should take about 2 minutes.

## What You'll Learn

> [card]
>
> How to create a test case

> [card]
>
> How to add test steps

> [card]
>
> How to use tags

> [card]
>
> How to save and track tests

## Create Your Test

**1. Open Test Management**

1. Log in to OneTest
2. Click **Test Management** in the sidebar
3. You'll see an empty test list (that's normal!)

**2. Click New Test Case**

Click the **"+ New Test Case"** button in the top right.

You'll see a form with several fields. Let's fill in the basics:

**3. Enter Basic Information**

### Title

Give your test a clear name that describes what it tests.

**Example:**

```
User can view dashboard after login
```

### Description (Optional)

Add more details if needed.

**Example:**

```
Verify that after successful login, the user
is redirected to the dashboard and can see
their profile information.
```

### Type

Select **Manual** (we'll cover automated tests later).

### Priority

Choose how important this test is:

| Priority | When to Use |
| - | - |
| **P0** | Critical (blocks release if fails) |
| **P1** | High (major feature) |
| **P2** | Medium (standard feature) |
| **P3** | Low |
| **P4** | Nice-to-have |

For this example, choose **P2**.

**4. Add Test Steps**

Click **"+ Add Step"** to add each step of your test.

For each step, enter:

* **Action** - What to do
* **Expected Result** - What should happen

**Example Steps:**

> [tab] Step 1
>
> * **Action:** `Navigate to login page`
> * **Expected:** `Login form is displayed`

> [tab] Step 2
>
> * **Action:** `Enter valid username and password`
> * **Expected:** `Credentials are accepted`

> [tab] Step 3
>
> * **Action:** `Click "Login" button`
> * **Expected:** `User is redirected to dashboard`

> [tab] Step 4
>
> * **Action:** `Verify dashboard page`
> * **Expected:** `Dashboard loads with user's name visible`

**5. Add Tags (Optional)**

Tags help you organize and find tests.

Add these tags:

```
smoke, login, ui
```

**Tag Usage:**

* **smoke** - Critical path tests
* **login** - Feature grouping
* **ui** - Test type

**6. Save Your Test**

Click the **"Create"** button at the bottom.

🎉 **Congratulations!** You've created your first test case!

You should see:

* Test identifier (e.g., `TC-0001`)
* Status: `Draft`
* Your test details

## What Just Happened?

OneTest automatically handled several things for you:

> [card] Unique ID Generated
>
> Every test gets a unique identifier like `TC-0001`

> [card] Version Tracking
>
> Created version 1 of your test for full history

> [card] Status Set
>
> Automatically set to "Draft" status

> [card] Metadata Tracked
>
> Recorded who created it and when

## Next Steps

Now that you've created your first test, here are some great next steps:

> [card] [Create More Tests](https://onetest.ai/ui/test-management.md)
>
> Try creating tests for common workflows:
>
> * User registration
> * Password reset
> * Checkout process

> [card] [Use AI to Generate Tests](https://onetest.ai/ai/generate-tests.md)
>
> Let the AI create complete tests for you automatically

> [card] [Organize Your Tests](https://onetest.ai/workflows/organizing-tests.md)
>
> Learn how to use folders and tags effectively

> [card] [Run Your Test](https://onetest.ai/ui/running-tests.md)
>
> Execute your test and track results

## Quick Tips

> [!NOTE]
>
> **Keep tests atomic** - One test = One scenario

> [!TIP]
>
> **Use clear titles** - Describe what is being tested, not how

> [!TIP]
>
> **Be specific in steps** - Anyone should understand what to do

> [!TIP]
>
> **Tag consistently** - Use the same tags across your team

## Need Help?

Having trouble? Try these:

> [card] Ask the AI
>
> Open the chat and type "How do I create a test?"

> [card] [Watch Video](https://youtube.com/@onetest)
>
> Video tutorial on creating tests

> [card] [Get Support](mailto:artem@onetest.ai)
>
> Email our support team

## What You Learned

> [!TIP]
>
> How to create a test case

> [!TIP]
>
> What fields to fill in

> [!TIP]
>
> How to add test steps

> [!TIP]
>
> How to use tags

> [!TIP]
>
> Where your test is stored

Ready for more? Pick your next guide above! 👆


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.