Skip to content

Commit 1f9b141

Browse files
authored
Merge pull request #569 from zihanKuang/open-team-invite
Add "Open Team Invite" section to Teams documentation
2 parents 75cd4b9 + 4654c4f commit 1f9b141

File tree

2 files changed

+30
-4
lines changed

2 files changed

+30
-4
lines changed

content/en/cloud/identity/teams/_index.md

Lines changed: 30 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ categories: [Identity]
66
tags: [teams]
77
---
88

9-
109
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.
1110

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

2019
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.
2120

22-
Learn more about the [organizational structure](/cloud/identity).
21+
>Learn more about the [organizational structure](/cloud/identity).
2322
24-
{{< alert type="info" title="Note">}}
23+
{{< alert type="info" title="Team Ownership">}}
2524
If you are the current team owner, you can’t remove yourself from the team until you transfer ownership to another team administrator.
26-
{{< /alert >}}
25+
{{< /alert >}}
26+
27+
## Open Team Invite
28+
29+
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.
30+
31+
![Process of open team invite](/cloud/identity/teams/open_team_invite.gif)
32+
33+
### When to Use
34+
35+
- **Large-Scale Member Recruitment:** Efficiently integrate many new members into project teams, especially during organizational expansion.
36+
37+
- **Structured Self-Service Enrollment:** Supports efficient, self-service team setup for urgent initiatives (e.g., agile sprints, training cohorts).
38+
39+
{{< alert type="info" title="For Organization-Specific Invitations">}}
40+
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/).
41+
{{< /alert >}}
42+
43+
### How it Works
44+
45+
1. **Copy Team Invite Link:** Click the **copy** button to get the "Team Invite Link".[^1]
46+
2. **User Onboarding with Team Invite Link:** When a user clicks the "Team Invite Link," the system handles their onboarding as follows:
47+
* **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.
48+
* **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.
49+
* **If the user is already in the organization (and has an account):** Upon using the link, they are added to the specific team.
50+
3. **Manual Alternative:** As an alternative, administrators can always manually add existing organization members to a team.
51+
52+
[^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

0 commit comments

Comments
 (0)