Organizations and teams

Organizations are the top-level container in qtrl. Every project, test, and team member belongs to one.

How organizations work

When you create an organization, you become its owner. From there, you can create projects, invite team members, and configure billing. All resources (projects, tests, tasks, test runs) live under the organization and share its subscription and credit pool.

Most companies create a single organization for their team. If you work across multiple companies or clients, you can belong to several organizations and switch between them from the sidebar.

Organization roles

Every member of an organization has one of three roles. These control what they can see and do across the organization:

  • Owner has full control. Owners can manage billing, invite or remove members, create and delete projects, configure integrations, and manage API keys. Every organization has at least one owner.
  • Admin can do most of what an owner can: manage projects, invite members, and configure settings. The main difference is that admins can't modify billing or delete the organization.
  • Member can work within the projects they're assigned to. They can create tasks, manage tests, run test executions, and view results. They can't access organization settings, billing, or API key management.

Inviting team members

Owners and admins can invite new members from the organization settings page. To send an invitation:

  1. Go to your organization's Settings tab.
  2. In the Members section, click "Invite Member."
  3. Enter the person's email address and choose a role (admin or member).
  4. Click "Send Invitation."

The invitee receives an email with a link to accept. When they click it, they're added to your organization with the role you assigned. If they don't have a qtrl account yet, they'll be prompted to create one first.

Pending invitations appear in the members list with an "Invited" badge. You can cancel a pending invitation at any time.

Managing members

From the Members section of organization settings, owners and admins can:

  • Change a member's role (for example, promote a member to admin).
  • Remove a member from the organization entirely.
  • View when each member joined and their current role.

Removing a member revokes their access to all projects and resources in the organization immediately.

Project-level access

Beyond organization roles, qtrl supports project-level access control. Organization owners and admins always have access to every project. Regular members only see projects they've been explicitly added to.

Within a project, members get one of three roles. A project admin can change the project's settings and manage who has access. A project member can create tests, run tasks, and view results. A project viewer can only view tests, runs, and results without making changes.

To manage project members, navigate to the project and open the Members tab. From there you can add organization members to the project and assign their project-level role.

Member limits

The number of team members your organization can have depends on your subscription tier. See Credits for details on what each plan includes.