User Management

EOS Hub provides user management tools for creating accounts, assigning system roles, and managing team memberships. This page covers the user lifecycle from creation to role assignment.

Creating Users

Via the Admin Panel

SUPERADMINs can create users directly:

1. Navigate to Admin > Users.
2. Click Create User.
3. Select the Auth Type:
   • Credentials -- Email and password login.
   • OAuth (Google) -- Google sign-in only.
4. Fill in the form:

Field	Credentials	OAuth
Name	Required	Optional (updated from Google profile on first sign-in)
Email	Required	Required
Password	Required	Not applicable
System Role	SUPERADMIN or USER	SUPERADMIN or USER

5. Click Create.

TIP

For OAuth users, create the account first with their Google email, then add them to teams. When they sign in with Google for the first time, their name and profile picture are automatically filled from their Google account.

TIP

After creating a user, add them to one or more teams via the team management page. A user without team membership will see an empty dashboard.

Via Google OAuth (Self-Registration)

If Google OAuth is configured, users can also sign in directly with their Google account without being pre-created. On first sign-in:

• A user record is created automatically.
• The system role defaults to USER.
• No team memberships are assigned -- an admin must add the user to teams.

Pre-Created OAuth Users

When a SUPERADMIN creates an OAuth user in advance, the user's account is ready and can be assigned to teams before they ever sign in. On their first Google sign-in:

• The existing account is linked to their Google OAuth profile.
• Name and profile image are updated from Google.
• Team memberships and roles are preserved as configured.

System Roles

Each user has exactly one system role:

Role	Description
SUPERADMIN	Full platform access, can manage all teams and users
USER	Standard user, access limited to assigned teams

Changing System Roles

1. Navigate to Admin > Users.
2. Find the user and click Edit.
3. Change the System Role dropdown.
4. Click Save.

WARNING

Revoking SUPERADMIN access from a user immediately restricts them to their team-based permissions. Ensure at least one SUPERADMIN account always exists.

Team Membership

Users participate in teams through TeamMember records. Each membership includes a team role (OWNER, ADMIN, MEMBER, or VIEWER).

Adding a User to a Team

1. Navigate to Admin > Teams.
2. Select the target team.
3. Click Add Member.
4. Select the user from the dropdown.
5. Choose a team role.
6. Click Save.

Removing a User from a Team

1. Navigate to the team's member list.
2. Click the remove icon next to the user.
3. Confirm the removal.

INFO

Removing a user from a team does not delete their account or affect their membership in other teams. It only removes their access to that specific team's data.

Changing Team Roles

1. Navigate to the team's member list.
2. Find the user.
3. Change their role using the dropdown.
4. The change takes effect immediately.

Editing User Profiles

To edit an existing user:

1. Navigate to Admin > Users.
2. Click on the user or the edit icon.
3. Update name, email, or system role.
4. Click Save.

Deactivating Users

When someone leaves the organization:

1. Remove them from all teams.
2. Optionally change their system role or delete their account.

TIP

Consider keeping departed users' accounts (removed from teams) rather than deleting them, so historical data (Rock ownership, To-Do assignments, meeting participation) remains intact.

User List

The Admin Panel displays all users with:

• Name and email
• System role
• Number of team memberships
• Account creation date

The list is searchable and sortable by any column.

Related Pages

• Admin Panel -- Full admin panel overview
• Roles & Permissions -- What each role can do
• Organizations & Teams -- How teams work