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

# Admin Settings

> Create roles, and control which users and permissions each one has.

The **Admin Settings** page manages **User Roles & Permissions** — who can do what across the system.

<Steps>
  <Step title="Open Configuration → Admin Settings">
    Every role is shown as a card: its name, description, Active/Inactive status, how many Users are assigned to it, and how many Permissions it has.

    A role you're currently assigned to shows an **Assigned** badge.
  </Step>

  <Step title="Click + Create Role and fill in the details across three tabs">
    **Basic Info**, **Users**, and **Permissions**.
  </Step>
</Steps>

<Note>
  **Admin**, **Owner**, and **Staff** are predefined roles — their name can't be changed, and they can't be deleted.
</Note>

<Tabs>
  <Tab title="Basic Info">
    | Field             | Required? | What to enter                                                                                          |
    | ----------------- | --------- | ------------------------------------------------------------------------------------------------------ |
    | **Role Name**     | Yes       | Each word must start with a capital letter and contain only letters, e.g. "HR Manager"                 |
    | **Description**   | Yes       | What this role can do                                                                                  |
    | **Active Status** | —         | Toggle on so users with this role can log in — turning it off blocks login for everyone with this role |
  </Tab>

  <Tab title="Users">
    Search by name or email, then check off which users have this role.

    <Note>
      A person shows up here once they've been added as an [Employee](/hr-payroll-module/employee/employee) — that's what creates their user account. Add them there first if you don't see them.
    </Note>

    You're always pinned to the top of the list as **Current User** and can't remove yourself from a role this way.
  </Tab>

  <Tab title="Permissions">
    Toggle **Business POS** on to give this role access to the POS interface, separate from the ERP admin panel.

    Below that, check off which pages this role is allowed to see, grouped the same way as the sidebar. Checking a group checks everything inside it too.
  </Tab>
</Tabs>

Save with **Create Role** (or **Update Role** when editing).