User Management Widget

A widget for displaying and managing users in your application.

The <UsersManagement /> widget allows an organization admin to manage the members in an organization. Admins can invite new users, remove users, and change roles all within the widget.

In order to use the User Management widget, a user must have a role that has the widgets:users-table:manage permission.

JavaScript

 import { UsersManagement, WorkOsWidgets } from '@workos-inc/widgets';

/**
 * @param {string} authToken - A widget token that was fetched in your backend. See the
 * "Tokens" section of this guide for details on how to generate the token
 */
export function UserTable({ authToken }) {
  return (
    <WorkOsWidgets>
      <UsersManagement authToken={authToken} />
    </WorkOsWidgets>
  );
}

 import { useAuth } from '@workos-inc/authkit-react';
import { UsersManagement, WorkOsWidgets } from '@workos-inc/widgets';

export function UserTable() {
  const { isLoading, user, getAccessToken } = useAuth();
  if (isLoading) {
    return '...';
  }
  if (!user) {
    return 'Logged in user is required';
  }

  return (
    <WorkOsWidgets>
      <UsersManagement authToken={getAccessToken} />
    </WorkOsWidgets>
  );
}

API Reference

Prop	Type	Default	Required
`authToken`	`AuthToken`	No default value	Required

User Management Widget

On this page

API Reference

Required Scopes: