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 6 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 enable a specific invitation method for users to join a particular team. This is intended to function like an [Open Org Invite Link](https://docs.layer5.io/cloud/identity/users/user-management/), but for a specific team, providing a direct way to invite members rather than adding them manually.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"a specific invitation method" - perhaps, this could be made into less abstract phrasing.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current UI still uses a checkbox,and it hasn't been fixed. I'm unsure what the intended UI element should be.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"intended to"? Rather, "does".


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

### Why Use Open Team Invite
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Refine your AI output, please.

Let's not call it "Open Team Invite".


* **Effortless Onboarding to Teams:** Provides a single invitation link that seamlessly guides users through account creation (if new), organization membership, and directly into the specific team.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is marketing fluff and AI generated content that is of little value. These are docs, not marketing website.

Focus on how the feature works, when to use it, best practices of using it and any caveats of its use.

* **Targeted Invitations:** Allows for precise invitations to particular teams using a dedicated, shareable link.

{{< 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/users/user-management/).
{{< /alert >}}

### How Open Team Invite Works

1. **Copy Team Invite Link:** After clicking the relevant UI element, the link is copied to your clipboard.[^1]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"After clicking the relevant UI element," - - too abstract.

Do we really need to tell our users that when they click "the relevant UI element" (the copy link button) that the link is then copied to clipboard? 🫤

Less AI, more Zihan.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current UI still uses a checkbox,and it hasn't been fixed. I'm unsure what the intended UI element should be.

2. **Share Link:** Distribute this copied "Team Invite Link" to the individuals you intend to invite to the team.
3. **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.
4. **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.