SpecGraphSpecGraph Docs
Settings & Administration

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:

RolePermissions
OwnerFull access including billing and organization deletion. Typically the primary account holder.
AdminCan manage members, departments, projects, and settings. Cannot delete the organization.
MemberCan participate in projects, fill in surveys, add wishes, and vote. Cannot manage team or settings.
ViewerRead-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:

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

ActionOwnerAdminMemberViewer
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

On this page