mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-22 22:17:55 +00:00
67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
|
---
|
||
|
|
id: invite-user
|
||
|
|
title: Invite
|
||
|
|
---
|
||
|
|
|
||
|
|
Admins can invite users to a workspace using their email addresses and assign them specific **[roles](/docs/user-management/role-based-access/user-roles)** and **[groups](/docs/user-management/role-based-access/custom-groups)** to manage permissions. The invited users receive an email with instructions to join the workspace, ensuring a seamless onboarding process.
|
||
|
|
|
||
|
|
## Steps to Invite a User
|
||
|
|
|
||
|
|
Role Required: **Admin** <br/>
|
||
|
|
|
||
|
|
1. Click on the settings icon (⚙️) on the bottom left of your dashboard.
|
||
|
|
|
||
|
|
2. Go to **Workspace settings > Users**. <br/>
|
||
|
|
(Example URL - `https://app.corp.com/nexus/workspace-settings/users`)
|
||
|
|
|
||
|
|
3. Click on the **Add users** button.
|
||
|
|
<img className="screenshot-full" src="/img/user-management/onboard-user/invite-user/add-user.png" alt="Add user button" />
|
||
|
|
|
||
|
|
4. Fill out the following details:
|
||
|
|
| Field | Required/Optional | Example |
|
||
|
|
|:-----|:---------|:-------|
|
||
|
|
| Name | Required | John Doe |
|
||
|
|
| Email address | Required | john@corp.com |
|
||
|
|
| Select groups | Required | USER ROLE: **Admin** |
|
||
|
|
| | Optional | CUSTOM GROUPS: **Manager** |
|
||
|
|
| [User metadata](/docs/user-management/onboard-users/user-metadata) | Optional | `{"apiKey": "abc123"}` |
|
||
|
|
|
||
|
|
<img className="screenshot-full img-m" src="/img/user-management/onboard-user/invite-user/user-details.png" alt="Invite User" />
|
||
|
|
|
||
|
|
5. Click on the **Invite users** button to send the invitation.
|
||
|
|
|
||
|
|
|
||
|
|
## Email Invitation
|
||
|
|
|
||
|
|
Pre-Requisite: **[Setup SMTP Server](/docs/tj-setup/smtp-setup/configuration)**
|
||
|
|
|
||
|
|
Once a user is invited to the workspace, they will receive an email containing a unique workspace invite link. By clicking the link, the user will be redirected to the workspace login or signup page to complete the onboarding process.
|
||
|
|
|
||
|
|
<img className="screenshot-full img-l" src="/img/user-management/onboard-user/invite-user/email.png" alt="Workspace Level Permissions" />
|
||
|
|
|
||
|
|
## Invitation URL
|
||
|
|
|
||
|
|
On Self-Hosted ToolJet, admins can copy unique invitation URL and share with the user.
|
||
|
|
|
||
|
|
<img className="screenshot-full" src="/img/user-management/onboard-user/invite-user/copy-link.png" alt="Workspace Level Permissions" />
|
||
|
|
|
||
|
|
## User Status
|
||
|
|
|
||
|
|
Admin users can track the status of users as follows:
|
||
|
|
|
||
|
|
### Self-Hosted ToolJet
|
||
|
|
|
||
|
|
- **Invited**: The user has been invited to join the workspace.
|
||
|
|
- **Active**: The user is a member of the current workspace.
|
||
|
|
- **Archived**: The user has been archived by the admin.
|
||
|
|
|
||
|
|
### ToolJet Cloud
|
||
|
|
|
||
|
|
- **Requested**: The user has been invited to the current workspace but doesn't have a ToolJet account.
|
||
|
|
- **Invited**: The user has been invited to the current workspace and has a ToolJet account.
|
||
|
|
- **Active**: The user is a member of the current workspace.
|
||
|
|
- **Archived**: The user has been archived by the admin.
|
||
|
|
|
||
|
|
<img className="screenshot-full" src="/img/user-management/onboard-user/invite-user/user-status.png" alt="Workspace Level Permissions" />
|
||
|
|
|