​
Roles and Permissions

Gradial supports two admin roles:
  • Organization Admin: Has access to all users, teams, environments, and settings. Can invite users, manage integrations, and assign roles org-wide.
  • Team Admin: Has access only to teams they’re assigned to. Can manage team members and settings but cannot see other teams or organization-wide configurations.
Your current role is displayed in the top-right corner of the Management Console.

​
Dashboard

The Dashboard provides a high-level overview of your organization’s structure and activity:
  • Organization Health: Displays user engagement and configuration status
  • Active Users: Number of users in the organization
  • Teams: Total number of active teams
  • Environments: Configured deployment targets
  • Integrations: Connected external services
  • Quick Actions: Shortcuts to invite users and create teams

​
People

The People tab allows you to manage user access and roles:
  • Search and filter users by name, email, or role
  • View team memberships and last active status
  • Invite new users
  • Assign team- or organization-level roles

​
Adding a Member

  1. Open the People tab and click + Add New User.
  2. Enter the user’s full name and email address.
  3. (Optional) Check “Make this user an organization administrator” for full org-level access.
  4. Click Next: Teams to assign the user to one or more teams. You can choose whether they are a Team Member or Team Admin.
  5. Click Next: Review, then Send Invitation.
The invited user will receive an email with a link to join the organization.

​
Teams

Teams help structure your organization by brand, department, or workflow. Each team can have its own members, environments, and integrations.
  • View teams with member counts and default environments
  • Assign or change a team’s default environment
  • Add or remove team members
  • Set team-level admin roles

​
Creating a Team

  1. Navigate to the Teams tab and click + Add Team.
  2. Provide a Team Name and a Team Key (used in URLs and APIs).
  3. Optionally, add a short description of the team.
  4. Click Next: Add Members to assign users and define their roles (Member or Admin).
  5. Click Next: Review, then Create Team.
Once created, you can further configure the team’s environments and integrations.

​
Environments

Environments represent deployment targets (e.g., Development, Staging, Production). They can be shared across teams or assigned specifically.
  • View and manage all deployment environments
  • Add new environments with names and keys
  • Assign teams to environments
  • Set default environments per team

​
Adding an Environment

  1. Go to the Environments tab and click + Add Environment.
  2. Enter an Environment Name (e.g., Program 3 - Staging).
  3. Enter a lowercase Environment Key (used for routing and integrations).
  4. (Optional) Add a description.
  5. Click Next: Assign Teams to select teams that will use this environment.
  6. Click Next: Review, then Create Environment.

​
Setting a Default Environment for a Team

  1. In the Teams tab, locate the team you’d like to update.
  2. Click the ••• menu on the team card and select Set Default Environment.
  3. Choose from the list of available environments and click Set Default Environment.
The selected environment will now be used by default in deployments and workflows for that team.