Skip to content

Users, teams & roles

A user is an individual account that signs in with an email and password (and optionally two-factor authentication). Every user belongs to one organization, can belong to any number of teams, and has exactly one role that decides what they're allowed to do.

Inviting users

Admins invite people from the organization's user management:

  1. Open Users (admin only) and choose to invite a new user.
  2. Enter the person's email and pick the role they should have (viewer, editor, or admin).
  3. Hexcovery sends an invitation. When the invited person accepts and signs in, they join your organization with the role you assigned.

Admins can later change a user's role or remove a user from the organization at any time from the same page.

Unlimited users

Hexcovery does not charge per user. You can invite as many people as you need.

Roles

There are three built-in roles. Each one is a superset of the one below it — an editor can do everything a viewer can, and an admin can do everything an editor can.

Role What it can do
Viewer Read dashboards, run queries, and view saved queries.
Editor Everything a viewer can do, plus create and edit dashboards, save queries, and manage their own account.
Admin Everything an editor can do, plus manage users, teams, organization settings, and API keys.

In short:

  • Viewer — read-only access to dashboards and queries.
  • Editor — read and build: create/edit dashboards and save queries.
  • Admin — full control of the organization: people, teams, settings, and API keys.

Only admins can invite or remove users, change roles, edit organization settings, manage API keys, and view the audit log.

Teams

Teams are optional groups of users within an organization — for example "Platform" or "SRE". They exist to make sharing simple: instead of sharing a dashboard or saved query with named individuals, you share it with a team, and everyone on the team gets access.

  • A team is a named group of users.
  • A user can belong to more than one team.
  • Dashboards and saved queries can be shared with a team (or with the whole organization). Members of a team see what's shared with it.

Admins create and manage teams and their membership from the Teams page.

Sharing model

Viewers can see what's been shared with them; editors can clone a shared dashboard or query and modify their own copy. Use teams to keep the right dashboards in front of the right people without managing access one user at a time.