Quick Start Guide

Getting Started with Testably

Follow this step-by-step guide to set up your account, create your first project, write test cases, and execute your first test run — all in under 5 minutes.

1. Sign Up

Create your Testably account using email signup or Google SSO. After registration you will receive a verification email to activate your account.

Tip: Google SSO skips the email verification step entirely, so you can start even faster.

1
Visit testably.app
Open your browser and navigate to the Testably homepage.
2
Click "Get Started Free"
Find the call-to-action button on the landing page to begin registration.
3
Enter email & password
Fill in your email and create a secure password, or click "Continue with Google" for SSO.
4
Verify your email
Check your inbox for a verification link and click it to activate your account.
5
Complete your profile
Set your display name and avatar to finish onboarding.

Tip: Want to explore first? Click "Try Sample Project" on the Dashboard to get pre-loaded test data instantly — no setup required.

2. Create Your First Project

Projects are the top-level container for all your test cases, runs, and milestones. Navigate to the Dashboard and click "New Project" to get started.

What is a prefix? The prefix is a short identifier (e.g. APP) used to generate unique test case IDs like APP-1, APP-2, etc.

1
Open Dashboard
After signing in you will land on the main Dashboard.
2
Click "New Project"
Use the button in the top-right area of the project list.
3
Enter project name
Give your project a descriptive name, e.g. "My App".
4
Set a prefix
Choose a short prefix like APP. This will be used for test case IDs (APP-1, APP-2, etc.).
5
Create
Click "Create" and your project is ready to go.

3. Create Your First Test Case

Test cases capture the steps and expected results for a specific scenario. Navigate to your project, open the Test Cases tab, and click "New Test Case".

Key Fields

TitleShort, descriptive name

PriorityCritical / High / Medium / Low

TypeManual or Automated

PreconditionSetup required before testing

StepsOrdered actions to perform

Expected ResultWhat should happen

Example: A login test case might be titled "Verify successful login with valid credentials", with steps like: (1) Navigate to login page, (2) Enter valid email, (3) Enter valid password, (4) Click "Sign In" — and an expected result of "User is redirected to the Dashboard".

1
Navigate to Test Cases
Open your project and select the Test Cases tab from the sidebar.
2
Click "New Test Case"
Use the action button at the top of the test case list.
3
Fill in the details
Enter a Title, set Priority (Critical / High / Medium / Low), choose Type (Manual or Automated), and add a Precondition if needed.
4
Add steps
Define each step the tester should perform. For each step, write the action and the expected result.
5
Save
Click "Save" to add the test case to your project.

4. Execute Your First Test Run

Test Runs let you execute a set of test cases and record results. Go to the Test Runs tab, click "Create Run", give it a name, and select the test cases you want to include.

Focus Mode: When you click "Execute", Testably opens Focus Mode — a distraction-free interface that lets you navigate through each test case one by one. Set each case's status to Passed, Failed, Blocked, Retest, or Not Tested. Always add a note when marking a case as Failed to help with debugging later.

1
Go to Test Runs
Navigate to the Test Runs tab in your project.
2
Click "Create Run"
Open the create run modal and give the run a descriptive name.
3
Select test cases
Choose which test cases to include in this run.
4
Enter Focus Mode
Click "Execute" to start running through the cases in Focus Mode.
5
Set results
For each case, set the status: Passed, Failed, Blocked, Retest, or Not Tested. Add notes for any failures.

5. Next Steps

Now that you have the basics down, explore these areas to get the most out of Testably.

Invite Team Members

Add your QA team and assign roles.

Set Up Milestones

Track progress toward releases.

Exploratory

Record exploratory testing sessions and convert to test cases.

CI/CD Integration

Automate test reporting in your pipeline.