Skip to content

Add "Open Team Invite" section to Teams documentation #569

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
May 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 30 additions & 4 deletions content/en/cloud/identity/teams/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ categories: [Identity]
tags: [teams]
---


Organizations are the basic unit of multi-tenancy inside of Layer5 Cloud. Organizations can have any number of teams. Teams can have any number of users. Users can belong to any number of teams. Users may belong to any number of organizations.

Outside of grouping users together, teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections.
Expand All @@ -19,8 +18,35 @@ A team is simply a group that an administrator can create in the Google Admin co

Below the top-level organization, you can add as many teams as you want - at the same level. Hierarchal teams are not currently supported. When you change a setting at the higher level organization, the settings for all child teams that inherit that setting also change. Custom settings at the team level, however, remain unchanged.

Learn more about the [organizational structure](/cloud/identity).
>Learn more about the [organizational structure](/cloud/identity).

{{< alert type="info" title="Note">}}
{{< alert type="info" title="Team Ownership">}}
If you are the current team owner, you can’t remove yourself from the team until you transfer ownership to another team administrator.
{{< /alert >}}
{{< /alert >}}

## Open Team Invite

The "Open Team Invite" feature allows administrators to use shareable "Team Invite Links" for users to join a particular team. This link-based invitation method functions much like an [Open Org Invite Link](https://docs.layer5.io/cloud/identity/organizations/org-management/), but is tailored for team-specific invitations and provides a direct alternative to adding members manually.

![Process of open team invite](/cloud/identity/teams/open_team_invite.gif)

### When to Use

- **Large-Scale Member Recruitment:** Efficiently integrate many new members into project teams, especially during organizational expansion.

- **Structured Self-Service Enrollment:** Supports efficient, self-service team setup for urgent initiatives (e.g., agile sprints, training cohorts).

{{< alert type="info" title="For Organization-Specific Invitations">}}
If your goal is to invite users only to a specific organization (and not directly to a team as part of the same invitation), please refer to the documentation on [Open Org Invite Link and User Management](https://docs.layer5.io/cloud/identity/organizations/org-management/).
{{< /alert >}}

### How it Works

1. **Copy Team Invite Link:** Click the **copy** button to get the "Team Invite Link".[^1]
2. **User Onboarding with Team Invite Link:** When a user clicks the "Team Invite Link," the system handles their onboarding as follows:
* **If the user has no system account:** They are guided through the account registration process. Upon successful registration, they are automatically added to **both** the relevant organization and the specific team.
* **If the user has a system account but is not in the target organization:** Upon using the link, they are added to **both** the organization and the specific team.
* **If the user is already in the organization (and has an account):** Upon using the link, they are added to the specific team.
3. **Manual Alternative:** As an alternative, administrators can always manually add existing organization members to a team.

[^1]: If the direct way to copy this link isn't fully visible or working correctly in the current version, this is a known issue that we plan to fix in an upcoming update.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.