User Management

Manage users and roles with comprehensive CRUD operations. Add, edit, delete users, assign roles, and organize your authentication system.

What the User Management Panel Does

The User Management panel provides a modal dashboard with two tabs:

• Users Tab - Complete user management with add, delete, role assignment, sorting, and pagination
• Roles Tab - Role management with create, edit, and delete operations

Prerequisites

• Active Transcodes project

Opening the User Management Panel

The User Management modal opens in the center with two tabs: Users and Roles.

Users Tab

The Users tab displays a comprehensive table of registered users with full management capabilities.

The Users tab shows:

• Registered Users section header
• + Add User button (top-right)
• User table with columns:
  • Email
  • Name
  • Registered (sortable with ↓)
  • Last Active (sortable with ↓)
  • Role (dropdown selector)
  • User UID (monospace font, truncated)
  • Actions (delete button)
• Pagination controls (Page 1+, < >)

View Users

The user table displays up to 50 users per page with pagination controls at the bottom.

Table columns:

Sort Users

To sort the user table:

1. Click any column header with a sort indicator (↓)
2. Available sort fields:
   • Registered (createdAt) - Sort by registration date
   • Last Active (updatedAt) - Sort by last activity (default)
3. Click again to reverse the sort order (asc ↔ desc)
4. Table automatically resets to page 1 when sorting changes

Add User

To add a new user:

1. Click the + Add User button (top-right)
2. The Add New User modal appears

3. Fill in the form fields:

4. Click CREATE USER
5. The user appears in the table immediately

Example metadata:

{
  "department": "engineering",
  "plan": "premium",
  "team": "backend"
}

Role assignment:

• Select a role from the dropdown (only shows existing roles)
• Leave empty to create user without role assignment
• Role can be assigned or changed later from the table

Update User Role

To change a user’s role:

1. Find the user in the table
2. Locate the Role column for that user
3. Click the role dropdown
4. Select a new role from the list:
   • user (default role)
   • Any custom roles you’ve created
5. The role updates automatically

Delete User

To delete a user:

1. Find the user in the table
2. Click the delete button in the Actions column
3. The Delete User confirmation modal appears

4. Review the confirmation message showing the user’s email
5. Click DELETE to confirm (or CANCEL to abort)
6. The user is permanently deleted immediately

Roles Tab

The Roles tab allows you to create, edit, and delete custom roles for your application.

The Roles tab shows:

• Role Management section header
• + Add Role button (top-right)
• Role table with columns:
  • Name
  • Description
  • Created At
  • Updated At
  • Actions (Edit button, Delete button)

View Roles

The role table displays all custom roles created for your project.

Table columns:

Add Role

To create a new role:

1. Click the + Add Role button (top-right)
2. The Add New Role modal appears

3. Fill in the form fields:

4. Click CREATE ROLE
5. The role appears in the table immediately

Role naming guidelines:

• Use lowercase letters, numbers, and underscores
• Examples: admin, moderator, editor, viewer, guest
• Role name must be unique within your project
• Role name cannot be changed after creation

Example role descriptions:

Full access to all features and settings

Can moderate content and manage users

Read-only access to content

Edit Role

To edit a role’s description:

1. Find the role in the table

2. Click the Edit button in the Actions column

3. The Edit Role modal appears

4. Update the Description field (Role Name is disabled and cannot be changed)

5. Click UPDATE ROLE

6. Changes are saved immediately

Delete Role

To delete a role:

1. Find the role in the table

2. Click the delete button in the Actions column

3. The Delete Role confirmation modal appears

4. Review the confirmation message

5. Click DELETE to confirm (or CANCEL to abort)

6. The role is removed immediately

Before deletion:

• Check the Users tab to see which users have the role assigned
• Remove the role assignment from all users using the role dropdown in the Users tab
• Once no users have the role assigned, you can delete the role

What to do next?

After managing users and roles:

1. Track user activity with analytics charts
2. Download user data backups for data retention
3. Configure authentication settings based on your user base
4. Review API Reference for programmatic user management