46360ca0c3
* initial refactor * initial draft for teams * restructed topics, added front matter * modified aliases * removes old files * removed files * initial refactor * initial draft for teams * restructed topics, added front matter * modified aliases * removes old files * removed files * final xrefs updates * xref adjustment * copy updates * copy and content updates to about, add to org, add user, admin * copy updates to remove user from org * update org vs server admin section names, cross-link * cross-link add and invite users to org * add remaining cross-links between org and server admin * add dashboard permissions table * add permissions information to teams * add copy invite instructions to invite management * tweaks and link updates * incorporated PM feedback * fixed xrefs * yarn prettier * fix codespell * combined teams and dashboard permissions content Co-authored-by: Mitchel Seaman <mitchel.seaman@gmail.com>
3.8 KiB
+++ title = "Invite a user to join an organization" aliases = ["docs/sources/administration/manage-users-and-permissions/manage-org-users/invite-user-join-org.md"] weight = 10 +++
Invite a user to join an organization
When you invite users to join an organization, you assign the Admin, Editor, or Viewer role which controls user access to the dashboards and data sources owned by the organization. Users receive an email that prompts them to accept the invitation.
- If you know that the user already has access Grafana and you know their user name, then you issue an invitation by entering their user name.
- If the user is new to Grafana, then use their email address to issue an invitation. The system automatically creates the user account on first sign in.
Note: If you have [server administrator]({{< relref "../about-users-and-permissions.md#grafana-server-administrators">}}) permissions, you can also manually [add a user to an organization]({{< relref "../../manage-users-and-permissions/manage-server-users/add-remove-user-to-org.md" >}}).
Before you begin
- Ensure you have organization administrator privileges.
- If the user already has access to Grafana, obtain their user name.
- Determine the permissions you want to assign to the user. For more information about organization permissions, refer to [Organization roles]({{< relref "../about-users-and-permissions/#organization-roles">}}).
To invite or add an existing user account to your organization:
-
Sign in to Grafana as an organization administrator.
-
To switch to the organization to which you want to invite a user, hover your mouse over your profile and click Switch organization and select an organization.
Note
: It might be that you are currently in the proper organization and don't need to switch organizations.
-
Hover your cursor over the Configuration (gear) icon in the side menu and click Users.
-
Click Invite.
-
Enter the following information:
Field Description Email or username Either the email or username that the user will use to sign in to Grafana. Name The user's name. Role Click the organization role to assign this user. For more information about organization roles, refer to [Organization roles]({{< relref "../about-users-and-permissions#organization-roles" >}}).. Send invite email Switch to on if your organization has configured. The system sends an email to the user inviting them to sign in to Grafana and join the organization. Switch to off if you are not using email. The user can sign in to Grafana with the email or username you entered. -
Click Submit.
If the invitee is not already a user, the system adds them.
.