User Management

Topographer provides tools for managing users within your organization. You can invite new users, manage their team memberships, and remove users who no longer need access.

Viewing Users

To see all users in your organization:

  1. Navigate to Organization → Users
  2. The user list shows each user’s email address and name
Users list showing organization members

Click on a user to view their details, including which teams they belong to.

Inviting Users

To invite a new user to your organization:

  1. Navigate to Organization → Users
  2. Click Invite Users
  3. Enter the email address(es) of the users you want to invite
  4. Select the team(s) to add them to
  5. Click Send Invite
Invite users dialog with email and team selection

The invited users will receive an email with instructions to join your organization.

ℹ️ Team Selection Required

When inviting users, you must select at least one team. New users are not automatically added to any team—you choose their initial team membership during the invitation process.

Inviting Multiple Users

You can invite multiple users at once by entering multiple email addresses. All invited users will be added to the same team(s) you select.

User Details

Click on a user in the users list to view their details page, which shows:

  • User information (name, email)
  • Team memberships
  • Roles inherited from each team
User detail page showing team memberships

Managing Team Membership

From the user detail page, you can:

Add user to a team:

  1. Click Add to Team
  2. Select the team
  3. Click Add

Remove user from a team:

  1. Find the team in the user’s team list
  2. Click the remove button
  3. Confirm the removal
💡 Access Changes

When you add or remove a user from a team, their access changes take effect immediately. The user may need to refresh their browser to see the updated permissions.

Removing Users

To remove a user from your organization:

  1. Navigate to the user’s detail page
  2. Click the remove button
  3. Confirm the removal

Removing a user from the organization:

  • Revokes their access to all projects
  • Removes them from all teams
  • Invalidates any active sessions
⚠️ Removal is Immediate

When you remove a user, they lose access immediately. Make sure you want to revoke all access before confirming.

First User Onboarding

The first user to register for an organization is automatically added to the Admins team. This ensures there’s always at least one administrator who can:

  • Invite additional users
  • Create teams
  • Manage organization settings

Subsequent users must be invited by an existing user with invite permissions.

User Preferences

Users can manage their own preferences by navigating to User → Preferences. Available settings include:

Name

Users can set their name, which appears throughout Topographer instead of their email address.

  1. Navigate to User → Preferences
  2. Enter your preferred name
  3. Click Save
User preferences page

Timezone

Users can select their preferred timezone, which affects how dates and times are displayed throughout the dashboard.

  1. Navigate to User → Preferences
  2. Select your timezone from the dropdown (or use the interactive map)
  3. Click Save

Permission Requirements

Different user management actions require different permissions. Generally:

  • All organization members can view the users list
  • Inviting and removing users requires administrative privileges
  • Managing team membership requires administrative privileges

If you don’t see certain buttons or options, you may not have the required permissions. Contact your organization administrator for access.

What’s Next?