TestOwl LogoTestOwlDocs

Creating a Project

A project is your team's workspace in TestOwl. Everything you build—tests, flows, environments, variables, secrets, run history, and team members—belongs to a project.

Think of a project as a container for a single application or product that you want to test. Each project is completely independent, making it easy to organise different applications, teams, or customers without sharing data between them.

When should you create a new project?

In most cases, create one project per application or product.

For example:

  • One project for your customer-facing website.
  • One project for your admin portal.
  • One project for your mobile web application.
  • One project for each client if you're an agency or consultancy.

Keeping related tests together makes it easier to manage environments, test data, team members, and execution history.

Avoid creating separate projects for individual features or modules. Instead, organise related functionality using Test Suites, Test Cases, and Flows within the same project.

Create a project

Creating a new project only takes a few seconds.

  1. 1
    Open the Project Switcher.
  2. 2
    Enter a project name.
  3. 3
    Click on + icon.
  4. 4
    You're ready to record your first test.

You can rename your project later from Settings → Manage Project.

Sample Demo Project

Every account includes a read-only Sample Demo Project with example test suites, flows, environments, and run history. It's a great place to explore TestOwl before creating your own project.

What belongs to a project?

Each project contains its own resources, including:

Project isolation

Projects are completely isolated from one another.

Resources created in one project are not shared with any other project, including:

  • Test Suites
  • Test Cases
  • Flows
  • Environments
  • Variables
  • Secrets
  • Run History
  • Reports
  • Team members

This isolation helps keep applications, customers, and teams organised.

Deleting a project

Warning

Only Project Owners can delete a project.
Deleting a project permanently removes everything inside it, including test suites, test cases, flows, environments, variables, secrets, run history, and reports.
This action cannot be undone.

Plan limits

Every project is subject to the limits of your current plan, such as the number of test suites, flows, environments, team members, and test executions that can be created.

For more information, see Plans & Usage.

Next steps