diff --git a/public/docs-static/img/how-to-guides/user-tab-list.png b/public/docs-static/img/how-to-guides/user-tab-list.png new file mode 100644 index 00000000..028c9b9a Binary files /dev/null and b/public/docs-static/img/how-to-guides/user-tab-list.png differ diff --git a/public/docs-static/img/how-to-guides/user-update-role.png b/public/docs-static/img/how-to-guides/user-update-role.png new file mode 100644 index 00000000..ad18f80f Binary files /dev/null and b/public/docs-static/img/how-to-guides/user-update-role.png differ diff --git a/src/pages/how-to/add-users-to-your-network.mdx b/src/pages/how-to/add-users-to-your-network.mdx index 0bf53645..3e0bed58 100644 --- a/src/pages/how-to/add-users-to-your-network.mdx +++ b/src/pages/how-to/add-users-to-your-network.mdx @@ -47,6 +47,21 @@ After logging in to the system, they will join your network automatically. This is a limitation that is likely to be removed in future versions. +## Manage user roles +NetBird has three user roles - `Owner`, `Admin`, and `User`. The roles allow you to control the level of access to the management API of your account. + +- `Owner` role - has full access to the account and can manage all aspects of the account. This role can not be assigned to multiple users. +- `Admin` role - has full access to the account except that they can't manage roles for Owner users or delete the account. +- `User` role - has limited access to the account, allowing users to view peers they own and others they can connect with. Users can create personal access tokens for programmatic access. + +To manage user roles, proceed to the `Users` tab and click on the user you want to update: +high-level-dia +After that, select the desired role from the dropdown: +high-level-dia +Click the `Save` button to save the changes. + + Only users with the `Owner` role can assign another user as `Owner`; this action will transfer the `Owner` role to another user, making the current user `Admin`. + ## Get started