> ## Documentation Index
> Fetch the complete documentation index at: https://help.pantaos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User management

> Add and manage users in the Admin Panel under the Users tab, with single and bulk invitations, role assignment, and lifecycle controls.

## What It Is

User management is the section of the Admin Panel where administrators handle people: invitations, roles, and lifecycle actions. It opens under **Admin Panel → Users** and is the source of truth for who can sign in to the workspace and what they can do once they are in.

The tab is organized around three states (active users, pending invitations, recently deleted) and four onboarding KPIs that show how invitations move through the process.

<Frame>
  <img alt="English Images Documentations (1) 4" title="English Images Documentations (1) 4" lightAlt="English Images Documentations (1) 4" darkAlt="English Images Documentations (1) 4" src="https://mintlify.s3.us-west-1.amazonaws.com/panta/images/English-Images-Documentations-(3)-1.png" className="dark:hidden" />

  <img alt="English Images Documentations (1) 4" title="English Images Documentations (1) 4" lightAlt="English Images Documentations (1) 4" darkAlt="English Images Documentations (1) 4" src="https://mintcdn.com/panta/7med5cXzbjoQe_Qx/images/English-Images-Documentations-5.png?fit=max&auto=format&n=7med5cXzbjoQe_Qx&q=85&s=9355bb4b426a2395eeb06a7fb96c44b5" className="hidden dark:block" width="1920" height="1080" data-path="images/English-Images-Documentations-5.png" />
</Frame>

## Why It Matters

Clean user management protects four things at once.

<CardGroup cols={2}>
  <Card title="Adoption" icon="rocket">
    New users land with the right role and the right invitation flow, so they start working immediately instead of waiting for a fix.
  </Card>

  <Card title="Access hygiene" icon="shield">
    Deactivated and deleted users stop consuming seats and budget. Pending invitations are visible, not lost in someone's inbox.
  </Card>

  <Card title="Onboarding visibility" icon="eye">
    Four KPIs at the top of the tab show how many users have been invited, how many have completed onboarding, how many are still in progress, and the resulting success rate.
  </Card>

  <Card title="Recoverable mistakes" icon="rotate-ccw">
    Deleted users stay in Recently Deleted for a limited time. A wrong delete can be undone before retention runs out.
  </Card>
</CardGroup>

## How To Use It

<Steps>
  <Step title="Open the Admin Panel" icon="shield">
    Click Admin at the bottom of the sidebar. Visible to administrators only.
  </Step>

  <Step title="Open Users" icon="users">
    Switch to the User  tab in the Admin Panel tab bar.
  </Step>

  <Step title="Read the onboarding KPIs" icon="heading-1">
    Four cards at the top show Invited users, Completed, Pending, and Completion rate. Use them as a quick health check before drilling into the user list.
  </Step>

  <Step title="Switch between the three tabs" icon="layout-grid">
    Active users shows users with completed onboarding. Pending invitations shows invitations that have not been accepted yet. Recently deleted shows users deleted within the retention window. Each tab shows a count next to its label.
  </Step>

  <Step title="Find a user" icon="search">
    Use the Search users field, or filter by role through the All roles dropdown.
  </Step>
</Steps>

## Adding Users

<Steps>
  <Step title="Click Add User" icon="plus">
    The button at the top right of the User management tab opens the add user dialog.
  </Step>

  <Step title="Choose Single import or Bulk import" icon="route">
    Single import invites a single user by email. Bulk import uploads an Excel file with multiple users.
  </Step>

  <Step title="Confirm the invitation" icon="send">
    Invited users appear in the Pending invitations tab until they accept and complete onboarding. The Invited users KPI increases by the number of new invitations.
  </Step>
</Steps>

## Roles

PANTA OS has two user roles. Both are visible as badges in the Role column of the user list.

<CardGroup cols={2}>
  <Card title="Admin" icon="shield">
    Full access to the Admin Panel, including user management, team management, integrations, Community Feed, organization settings, and token limits. Administrators manage other users and the workspace configuration.
  </Card>

  <Card title="Standard user" icon="user">
    Standard end user role. Access to chats, assistants, apps, the library, and personal settings. No access to the Admin Panel.
  </Card>
</CardGroup>

A user role is set in the user's profile and shown as a badge in the user list. Filter the user list by role through the All Roles dropdown at the top of the table.

## Managing The User Lifecycle

<CardGroup cols={2}>
  <Card title="Edit a user" icon="user">
    Click the edit icon in the Actions column of the user list to change a user's role or other profile details.
  </Card>

  <Card title="Resend an invitation" icon="mail">
    For pending invitations, open the Pending Invites tab and resend the invitation if it did not reach the user.
  </Card>

  <Card title="Delete a user" icon="trash">
    Click the delete icon in the Actions column. The user moves to the Recently deleted tab; access ends immediately.
  </Card>

  <Card title="Restore a deleted user" icon="rotate-ccw">
    In the Recently Deleted tab, use the restore action to bring the user back. The user returns to the active list with their previous role.
  </Card>

  <Card title="Permanent delete" icon="trash-2">
    From the Recently Deleted tab, deletion can be confirmed permanently. After permanent deletion, the user cannot be restored.
  </Card>
</CardGroup>

## Key Settings or Options

<CardGroup cols={2}>
  <Card title="Onboarding KPIs" icon="columns-3">
    Four cards showing Invited users, Completed, Pending, and Completion rate. A quick read on how invitations are progressing.
  </Card>

  <Card title="Three tabs" icon="layout-grid">
    Active Users, Pending Invites, Recently Deleted. Each shows a numeric count.
  </Card>

  <Card title="Search and role filter" icon="search">
    The Search users field searches the visible tab. The All roles dropdown filters by Admin or Standard user.
  </Card>

  <Card title="Two roles" icon="user">
    Admin (full Admin Panel access) and Standard user (standard end user). No additional role tiers.
  </Card>

  <Card title="Two add user paths" icon="plus">
    Single import for manual invitations, Bulk Upload for Excel based bulk invitations. Both reached through Add User.
  </Card>

  <Card title="Retention window" icon="clock">
    Deleted users stay in Recently Deleted for a limited time, during which they can be restored.
  </Card>
</CardGroup>

## Tips and Best Practices

* Default new users to the Standard user role. Promote to Admin only when the person needs to manage other users or workspace configuration.
* Watch the Pending invitations count. A growing number means people are receiving invitations but not completing onboarding; resend or follow up.
* Use Bulk import for rollouts. A clean Excel file is faster than dozens of single invitations.
* Delete instead of leaving inactive accounts in place. Deleted users can be restored within the retention window, so the operation is reversible.

<Tip>
  Permission management in PANTA OS is intentionally simple: two roles, three lifecycle states, two add paths. The approach is meant to keep administration light without sacrificing control.
</Tip>

## Help Center

<AccordionGroup>
  <Accordion title="Where is user management" icon="map-pin">
    Open Admin Panel from the bottom of the sidebar, then switch to the User  tab.
  </Accordion>

  <Accordion title="How many roles exist" icon="user">
    Two: Admin and User. Admins have full Admin Panel access; User is the standard end user role.
  </Accordion>

  <Accordion title="How do I invite many users at once" icon="upload">
    Click Add User and choose Bulk Upload. Upload an Excel file with the users you want to invite. Single invitations are handled through manual import on the same dialog.
  </Accordion>

  <Accordion title="What happens to a deleted user" icon="user-minus">
    Deleted users move to the Recently Deleted tab for a limited time. During that window, admins can restore the account. After the window closes, the user is removed permanently.
  </Accordion>

  <Accordion title="Can a user be active in more than one role" icon="circle-help">
    No. Each user has exactly one role at a time. Change it through the edit action in the user list.
  </Accordion>

  <Accordion title="What do the onboarding KPIs show" icon="bar-chart">
    Invited users is the total number of invitations sent. Completed is the number of users who completed onboarding. Pending is the number still in progress. Completion rate is the resulting success rate as a percentage.
  </Accordion>
</AccordionGroup>
