What this module does
TestFactors organizes access in a hierarchy: Organization → Client → Project. People (called members) join at one or more of these levels with a role that determines what they can do. A few key ideas:- Membership is per-scope — you can be an Org Admin on Org A and just a Tester on a Project under Org B. They’re independent.
- Authority cascades down — an Org Admin automatically has Admin rights on every Client and every Project under that Org.
- Authority never cascades up — a Tester on Project X cannot see anything about the parent Client or Org.
- Invitations work for any email — invite people who don’t have TestFactors accounts yet; they get an email and accept on first sign-in.
The role system
TestFactors has a rich role catalog — but you’ll usually only use a handful. Here’s the cheat sheet:Authority ranking (briefly)
Roles have a rank (0–100). A role with rank X can manage members of rank X or lower. You cannot promote someone to a role higher than your own — TestFactors prevents this server-side.Step-by-step: invite a teammate to a project
Open the project you want to invite into

Project Settings page with Members tab selected showing current members and pending invitations.
Click + Add Member
Enter their email and pick a role
- Email — the email of the person to invite
- Role — pick from the dropdown (Tester, Developer, Test Coordinator, etc.)

Add Member panel with email and role fields and an Invite button.
Click Invite
- Email matches an existing TestFactors user → they’re added immediately to the project; they’ll see it on their next login.
- Email is brand new → an invitation is sent. They click the link in the email, sign up (or sign in if they already have a TestFactors account on a different email), and are added automatically.

Confirmation toast: 'Maria Garcia added as Tester' or 'Invitation sent to [email protected]'.
Changing someone’s role
Find them in the Members list
Click the role dropdown

Member row with role dropdown open showing all valid role options.
Confirm if prompted
Removing a member
Find them in the Members list
Click the ⋮ menu → Remove

Member row with action menu open showing the Remove option in red.
Confirm
Pending invitations
Invitations to email addresses that aren’t TestFactors users yet show as Pending in the Members list. For each pending invitation you can:- Resend the invitation email (useful if it went to spam or was missed)
- Revoke the invitation (the link in the original email stops working)
- Copy the invite link to share via Slack/Teams

Pending invitations list showing two invitations with Resend / Revoke / Copy-link actions.
Managing access at higher scopes
The same pattern works at Client and Organization scope:- Client members → Client Settings → Members. Granted users see every Project under that Client.
- Org members → Org Settings → Members. Granted users see every Client and every Project under that Org.
- Org Admin — your TestFactors champion who owns the platform for your company
- Client Manager — the lead for one customer engagement (often consulting firms have one per client)
- Support Staff at Org scope — your finance person who needs read access but no editing

Org Settings with Members tab showing org-scope memberships.
The People panel — see who has access to what
The People panel shows the full access tree for a specific person across your visible scope. Use it for:- Auditing access — “Where exactly does Maria have access?”
- Bulk assignment — assign her to multiple projects at once
- Quick removal — see and revoke all her access in one place
Find the person
View the tree

People panel showing one user's full access tree with assigned and unassigned scopes.
Click + Assign on any unassigned node
Tips
Default new members to Tester or Viewer
Avoid Project Manager for everyone
Use Org-scope membership for cross-project people
Review access quarterly
Resend invitations after 3 days
Don't role-cheat
Troubleshooting
The role I want to assign isn't in the dropdown
The role I want to assign isn't in the dropdown
- Ask someone with higher authority (Client Manager or Org Admin) to make the assignment
- Pick a lower role that gets the person started; they can be promoted later
I removed someone, then realized I shouldn't have
I removed someone, then realized I shouldn't have
My invitation says 'Expired'
My invitation says 'Expired'
I want to bulk-add people from a CSV
I want to bulk-add people from a CSV
I'm the only admin on this project and I can't remove myself
I'm the only admin on this project and I can't remove myself
A teammate says they can't see something I can
A teammate says they can't see something I can
- Are they a member of the same project/client/org? Check Members list.
- Is their role sufficient? Compare with the role table at the top of this guide.
- Is their membership Active? Sometimes memberships get deactivated — toggle in the People panel.
I want to revoke access without removing membership history
I want to revoke access without removing membership history