Documentation

Everything you need to set up, configure, and get the most out of TestOrchestrator.

🚀

Getting Started

Create a workspace, accept an invitation, and log in for the first time.

⚙

Personal Settings

Your own profile photo and name, the sign-in email change, date and time preferences, and the optional emails.

👤

Users & Access

Understand the access model — Access Levels, Roles, and each project’s access default and exceptions.

🔒

Authentication

Workspace SSO via OIDC — plus the legacy password controls, which no longer govern sign-in.

📄

Projects

Create and manage projects, control who has access, and configure per-project roles.

📋

Fields

Define custom metadata fields for test cases, results, and sessions — with per-project environment.

📄

Templates

Define reusable field layouts for test cases and sessions — control which fields appear, what's required, and what's pre-filled.

☑

Statuses

Define and manage test result statuses — control scope availability, semantic meaning, and per-project assignment.

⚙

Environments

Define the platform combinations runs are recorded against — group your platforms into axes, then multiply them into environments.

🔄

Workflows

Define the workflow states test cases, test runs, and explorations move through, and the automation that moves them.

🔗

Integrations

Connect TestOrchestrator to Jira, GitHub, Azure DevOps, and more — link test cases and runs to external issues.

🏴

Cycles

Define cycle types — Sprints, Releases, Iterations — that project teams use to track progress checkpoints and goals.

🏷

Tags

Create labels for test cases, runs, and sessions — with custom icons and colors — to categorise and filter work across your projects.

📝

Test Cases

Create, organise, and manage test cases — use folders, templates, filters, and grouping to build a comprehensive test repository.

▶

Test Runs

Create test runs, execute test cases, record results step by step, and track progress with cycles and activity timelines.

🔬

Explorations

Create freeform exploratory testing sessions, log findings with rich notes and statuses, and track discovery across your team.

💳

Plans & Billing

What each plan includes, what happens at a limit or after a downgrade, asking an admin to upgrade, and the billing portal.