Team Management
How to invite members, manage roles, organize departments, and control access in SpecGraph.
Team Management
Team management in SpecGraph covers inviting new members, assigning them to departments, and controlling their access level through roles. Access to team management requires admin or owner role.
Roles
Every user in SpecGraph has a role within their organization:
| Role | Permissions |
|---|---|
| Owner | Full access including billing and organization deletion. Typically the primary account holder. |
| Admin | Can manage members, departments, projects, and settings. Cannot delete the organization. |
| Member | Can participate in projects, fill in surveys, add wishes, and vote. Cannot manage team or settings. |
| Viewer | Read-only access. Can see projects and PRDs but cannot add wishes, vote, or approve. |
Departments
Departments are the primary organizational unit for wishes and surveys. Each user belongs to a department, and surveys are distributed per department. To manage departments:
Navigate to Settings → Departments. From here you can:
- Create a department — add a name and choose a color. Department colors appear on wish cards, graph nodes, and conflict comparisons throughout the platform.
- Edit a department — change the name or color.
- Delete a department — only possible if no users are currently assigned to it.
Department colors are important — they're the main visual cue used throughout the platform to identify which team a wish or comment came from. Choose distinct, easily distinguishable colors for each department.
Inviting Members
There are two ways to add members to your organization:
Invitation Link
Navigate to Settings → Team and click Invite Member. Fill in:
- Email address — the person to invite.
- Role — the role they'll be assigned when they accept.
- Department — the department they belong to.
SpecGraph sends an invitation email with a unique link. The link expires after 7 days. You can view and revoke pending invitations from the Team page.
When the invited person clicks the link, they'll be prompted to set a password and their account will be created automatically with the role and department you specified.
Direct Creation (Admin Only)
System administrators can create accounts directly without sending an invitation. This is useful for onboarding large teams at once. Contact your system administrator if you need bulk user creation.
Managing Existing Members
From Settings → Team, you can see all members of your organization with their name, email, role, and department. For each member you can:
- Change their role — promote to admin, demote to member, etc.
- Change their department — move them to a different team.
- Remove them from the organization — this doesn't delete their account but removes their access to this organization's projects.
Switching Organizations
If a member belongs to multiple organizations, they can switch between them using the org switcher in the sidebar. Each organization maintains its own project list, department structure, and settings independently.
Access Control Summary
| Action | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| View projects and PRDs | ✓ | ✓ | ✓ | ✓ |
| Fill in surveys, add wishes | ✓ | ✓ | ✓ | — |
| Vote on wishes | ✓ | ✓ | ✓ | — |
| Participate in conflict discussion | ✓ | ✓ | ✓ | — |
| Approve PRDs | ✓ | ✓ | ✓ | — |
| Create and manage projects | ✓ | ✓ | — | — |
| Manage team members | ✓ | ✓ | — | — |
| Manage departments | ✓ | ✓ | — | — |
| Configure guardrails | ✓ | ✓ | — | — |
| Manage organization settings | ✓ | ✓ | — | — |
| Delete organization | ✓ | — | — | — |