TestOwl LogoTestOwlDocs

How to Navigate the TestOwl Interface

Take a quick tour of the TestOwl interface before you start building and running automated tests.

Everything you build in TestOwl belongs to a project (see Creating a Project). Once you open a project, the left sidebar gives you access to every major feature, from creating tests to reviewing execution results.

SectionWhat you'll find there
DashboardA high-level view of your project's health: suite and test counts, pass-rate and duration trends, environment coverage, and your most unstable tests. See Dashboard.
HomeThe fastest way to start a new test — either record it yourself, or switch to Describe with AI and let AI perform a plan you type. See Recording a Test and Creating Tests with AI.
Test SuitesGroup related test cases into suites for easier management and execution. See Test Suites.
TestsEvery test case in your project in one searchable list, regardless of suite. See Test Cases.
Run HistoryEvery test execution with its status, runner, environment, and duration. Open any run to see its report. See Run History.
Schedule RunsRun suites or tests automatically, once or on a repeating schedule. See Scheduling Runs.
FlowReusable groups of steps that can be shared across test cases. See Flows.
Import TestsBring in existing Playwright, Cypress, Selenium, Robot Framework and other tests. See Import Wizard.
EnvironmentConfigure where and how your tests run: browser, device, locale, network, and more. See Environments.
Data ConfigProject-wide Variables and Secrets you can reuse instead of hardcoding values. See Variables and Secrets.
Recycle BinRestore or permanently delete items you've deleted. Items are kept for 15 days. See Recycle Bin.
SettingsSecurity & Privacy (masking rules), User Management, Manage Project (plan and usage), Manage Tags, and Billing (Owner only). See Settings.

At the bottom of the sidebar:

ItemWhat it does
Help DocsOpens this documentation.
FeedbackRate your experience and send suggestions. See Sending Feedback.
Report IssueReport a bug with screenshots. See Reporting an Issue.
LogoutSign out of TestOwl.

Recording and Local runs need the Desktop App

Recording tests and running them on your own machine (Local runs) happen inside the TestOwl Desktop App. On the web, Record is turned off and Local runs are unavailable, but you can do everything else — build tests, run them on the Cloud, and read reports. If the app isn't installed yet, click Download App in the sidebar. See The Desktop App.

Settings

Settings groups the project-level configuration into tabs:

TabWhat it's for
Security & PrivacyMasking rules that hide sensitive data in screenshots and videos. See Masking Rules.
User ManagementInvite teammates, change roles, and manage invitations. See Inviting Team Members.
Manage ProjectRename or delete the project, and see its plan, quota, and usage. See Plans & Usage.
AI CreditsYour project's Ask AI and Describe with AI balance, usage, and credit pack purchases. See AI Credits & Usage Limits.
Manage TagsCreate and manage tags for tests, suites, and flows. See Tags.
BillingChoose a plan, pay, and download invoices. Visible to the project Owner only. See Billing & Subscriptions.

The top bar

The bar across the top of every page has:

  • Breadcrumbs showing where you are.
  • Search — press Ctrl/⌘ + K to jump to any test, suite, flow, run, and more. See Global Search.
  • Tour — replay the Quick Tour or the Full Product Tour. See Guided Tours.
  • Notifications (the bell) — alerts about your plan, quota, schedules, and billing. See Notifications.
  • Project Plan — the plan of the project you have open.
  • Account menu — your account, Settings, and Logout.

Working with projects

You can belong to multiple projects. Each project is completely independent and has its own:

  • Test Suites, Test Cases, and Flows
  • Environments
  • Variables and Secrets
  • Schedules
  • Run History and Reports
  • Team members and permissions
  • Plan and settings

Use the Project Switcher at the top of the sidebar to switch between projects, or to create a new one.

Explore the Sample Demo Project

Every account includes a read-only Sample Demo Project filled with example test suites, flows, environments, and execution history. It's a great way to explore TestOwl and see how a real project is organised before creating your own.
Learn more in Creating a Project.

Next steps

Last updated:

Maintained by the TestOwl product team.