Organizations, Teams, Members & Team Members

This guide covers how to work with Organizations, Teams, and their members in HighFly.

Organizations

Organizations are the top-level containers in HighFly. They represent companies, departments, or any group that needs to collaborate.

Creating an Organization

When you first sign up, you'll be prompted to create an organization. You can also create additional organizations from your dashboard.

Organization Settings

Each organization has settings that can be managed by owners and admins:

• Name: The display name
• Members: Manage who has access to the organization
• Teams: Create and manage teams within the organization
• GitHub Integration: Link GitHub organizations or personal accounts
• Subscriptions: Manage billing and subscription plans
• Notifications: Configure notification preferences

Organization Roles

Organizations have role-based access control:

• Owner: Full control over the organization, including billing and deletion
• Admin: Can manage members, teams, and most settings
• Member: Can access teams and issues they're assigned to

Teams

Teams are sub-groups within an organization. They help organize work by project, department, or any logical grouping.

Creating Teams

1. Navigate to your organization
2. Click "Create Team" or go to Teams settings
3. Provide a name and optional prefix (used for issue identifiers)
4. The team will be created and ready to use

Team Settings

Each team has its own settings:

• Name: Team identifier
• Prefix: Used for issue identifiers (e.g., "ENG" for "ENG-123")
• Members: Manage team membership
• Labels: Create and manage issue labels
• Issues: View and manage all team issues

Team Membership

Team members can be added in several ways:

• Organization Members: Add existing organization members to the team
• External Invitations: Invite users who aren't yet organization members

Team Roles

Team membership doesn't have separate roles - team members inherit their permissions from their organization role. However, team-specific permissions may be added in the future.

Members

Members are users who belong to an organization. They can be assigned to teams and issues.

Adding Members

Organization owners and admins can add members:

1. Go to Organization Settings → Members
2. Click "Invite Member"
3. Enter the email address
4. Select a role (Owner, Admin, or Member)
5. Send the invitation

Managing Members

Owners and admins can:

• View all organization members
• Change member roles
• Remove members from the organization
• Resend invitations

Team Members

Team members are organization members who have been added to specific teams. They can:

• View and create issues in that team
• Be assigned to issues
• Comment on team issues
• Access team-specific resources

Adding Team Members

1. Navigate to the team
2. Go to Team Settings → Members
3. Click "Add Member"
4. Select from organization members or invite new users

Team Member Permissions

Team members can:

• Create and edit issues in their teams
• Comment on issues
• Update issue status, priority, and assignees
• Manage labels (if they have admin permissions)

Invitations

HighFly uses an invitation system for adding members to organizations and teams.

Organization Invitations

When you invite someone to an organization:

• They receive an email invitation
• The invitation includes a link to accept
• Invitations expire after 14 days
• Once accepted, they become organization members

Team Invitations

Team invitations work similarly:

• Invite existing organization members directly
• Invite external users (they'll join the organization first)
• Invitations are sent via email but the link can be copied through the UI

Managing Invitations

You can:

• View pending invitations
• Resend invitations
• Cancel pending invitations
• See invitation status and expiration dates

Best Practices

• Organize by Structure: Create organizations that match your company structure
• Use Teams for Projects: Create teams for different projects or initiatives
• Manage Roles Carefully: Only grant Owner or Admin roles to trusted team members
• Keep Members Updated: Regularly review and update team memberships as projects evolve