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

# User Roles and Permissions | Control System Access

> Learn how to create user roles, assign module-level permissions, and manage user access in Kuvera Arc to control what each team member can do.

User Roles and Permissions is the access control module in Kuvera Arc. Use it to define what each team member can view, create, update, approve, void, or manage across inventory, sales, purchase, finance, configuration, reports, and e-commerce workflows.

<Info>
  Roles define permissions. Users inherit permissions from their assigned role. Changes to a role apply immediately to every user assigned to that role.
</Info>

## How roles and users work

Roles and users work together to control system access.

<Frame caption="User Roles and Permissions page" />

<CardGroup cols={2}>
  <Card title="Roles" icon="user-shield">
    Define what users can see and do across modules.
  </Card>

  <Card title="Users" icon="users">
    Assign people to roles and branches so they can work within the right scope.
  </Card>

  <Card title="Permissions" icon="list-check">
    Control actions such as view, create, update, approve, enable, disable, and void.
  </Card>

  <Card title="Branches" icon="folder-tree">
    Limit user scope to the locations relevant to their work.
  </Card>
</CardGroup>

## Module tabs

<Tabs>
  <Tab title="Roles and Permissions">
    Manage access roles, configure module-level permissions, define allowed actions, and control visibility across Kuvera Arc.
  </Tab>

  <Tab title="Users">
    Manage user accounts, assign branches, assign roles, enable or disable accounts, and view active or inactive users.
  </Tab>
</Tabs>

## Access User Roles and Permissions

<Steps>
  <Step title="Open Configuration">
    From the left navigation panel, go to **Configuration**.

    <Frame caption="Configuration in the sidebar" />
  </Step>

  <Step title="Select User Roles and Permissions">
    Click **User Roles and Permissions**.

    <Frame caption="User Roles and Permissions menu item" />
  </Step>

  <Step title="Choose a tab">
    Select **Roles and Permissions** or **Users** depending on what you need to manage.
  </Step>
</Steps>

## Roles and Permissions tab

The Roles and Permissions tab lists configured access roles. Each role includes a name, description, and options menu.

<Frame caption="Roles and Permissions tab" />

<Info>
  Some default roles are created automatically during account setup. The Super Admin role is fixed and cannot be edited or disabled.
</Info>

<AccordionGroup>
  <Accordion title="Edit Role Permissions">
    Opens the role configuration page where you can update the role name, description, discount permission, and module-level permissions.

    Changes apply immediately to every user assigned to that role.
  </Accordion>

  <Accordion title="Disable Role">
    Deactivates the role so it can no longer be assigned to new users.

    System-protected roles cannot be disabled.
  </Accordion>
</AccordionGroup>

## Create a new role

<Steps>
  <Step title="Open Roles and Permissions">
    Go to **Configuration > User Roles and Permissions** and select the **Roles and Permissions** tab.
  </Step>

  <Step title="Click Add New Role">
    Click **Add New Role**.

    <Frame caption="Add New Role button" />
  </Step>

  <Step title="Enter role information">
    Fill in the role name, optional description, and discount permission.

    <Frame caption="Role information fields" />
  </Step>

  <Step title="Configure permissions">
    Use permission checkboxes to assign the appropriate access level for each module.
  </Step>

  <Step title="Save the role">
    Click **Save Details**. The role becomes available for user assignment.
  </Step>
</Steps>

## Role information fields

<AccordionGroup>
  <Accordion title="Role Name">
    Required. Use a clear name that reflects the team function, such as **Sales Executive**, **Finance Manager**, or **Warehouse Manager**.
  </Accordion>

  <Accordion title="Description">
    Optional. Add a short explanation of the role's purpose so administrators can understand its intended scope.
  </Accordion>

  <Accordion title="Allow the role to provide discount">
    Optional. When enabled, users assigned to this role can apply discounts in supported sales workflows, such as sales orders or invoices.
  </Accordion>
</AccordionGroup>

## Permission actions

Each module supports a combination of permission actions. Available checkboxes depend on what each module supports.

<CardGroup cols={2}>
  <Card title="View" icon="eye">
    Allows the user to open and read records or module data.
  </Card>

  <Card title="Create" icon="plus">
    Allows the user to add new records.
  </Card>

  <Card title="Update" icon="pen-to-square">
    Allows the user to edit existing records.
  </Card>

  <Card title="Enable / Disable" icon="toggle-on">
    Allows the user to activate or deactivate records.
  </Card>

  <Card title="Approve" icon="circle-check">
    Allows the user to approve workflow records such as purchase orders, invoices, or adjustments.
  </Card>

  <Card title="Void" icon="ban">
    Allows the user to cancel or void finalized records where supported.
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Full Access">
    All available actions are checked for the module.

    Use this for managers and senior staff who need complete control over records in that area.
  </Tab>

  <Tab title="View Only">
    Only **View** is checked.

    Use this for users who need visibility for reporting or reference but should not modify data.
  </Tab>

  <Tab title="No Access">
    No actions are checked.

    Use this to hide or restrict modules unrelated to a role's responsibilities.
  </Tab>
</Tabs>

## Permission categories

Permissions are organized by module group.

<AccordionGroup>
  <Accordion title="Dashboard">
    Controls access to the main dashboard and its summary widgets.
  </Accordion>

  <Accordion title="Inventory">
    Covers Products, Measurement Units, Product Attributes, Product Categories, Variant Products, Adjust Inventory, Barcode Mapping, Material Transfer, Stock Issue, Requisition Entry, and In Transit Stock.
  </Accordion>

  <Accordion title="Purchase">
    Covers Purchase Orders, Purchase Bills, Bill Payments, Suppliers, Debit Notes, and Goods Received Notes.
  </Accordion>

  <Accordion title="Sales">
    Covers Sales Orders, Credit Notes, Invoices, Invoice Payments, and Customers.
  </Accordion>

  <Accordion title="Finance">
    Covers Bank Accounts, Accounts Receivable, Accounts Payable, Cash Flow, and Cash Adjustments.
  </Accordion>

  <Accordion title="Organization Configuration">
    Covers Company, Branch, Warehouse, Inventory Configuration, Terms and Conditions, Opening Stock, Opening Balance, and Remove Draft.
  </Accordion>

  <Accordion title="Tax and Payment Configuration">
    Covers Tax setup, Payment Terms, and Payment Methods.
  </Accordion>

  <Accordion title="User Configuration">
    Covers user management and role permission management. Restrict this category to administrators.
  </Accordion>

  <Accordion title="Reports">
    Covers VAT Reports, Sales Reports, Purchase Reports, and Inventory Reports.
  </Accordion>

  <Accordion title="Import / Export">
    Controls the ability to import and export data across modules.
  </Accordion>

  <Accordion title="Print Configuration">
    Covers print settings and Invoice Configuration permissions.
  </Accordion>

  <Accordion title="Fiscal Year">
    Controls the Transfer Fiscal Year operation.
  </Accordion>

  <Accordion title="Settings">
    Covers Notification Settings, Profile Settings, General Settings, and Plan Subscription visibility.
  </Accordion>

  <Accordion title="Ecommerce Management">
    Controls access to Ecommerce Configuration.
  </Accordion>
</AccordionGroup>

<Warning>
  Removing permissions from a role with active users takes effect immediately. Confirm affected users are not in critical workflows before saving permission changes.
</Warning>

## Users tab

The Users tab lists user accounts in your system. Use it to view user details, filter by branch, edit users, disable users, or add new users.

<Frame caption="Users tab" />

## Access the Users tab

<Steps>
  <Step title="Open Configuration">
    Go to **Configuration**.
  </Step>

  <Step title="Open User Roles and Permissions">
    Select **User Roles and Permissions**.
  </Step>

  <Step title="Select Users">
    Click the **Users** tab to view the user listing.
  </Step>
</Steps>

<Tip>
  Use the branch selector at the top of the Users tab to filter users when managing teams across multiple locations.
</Tip>

## User listing actions

<AccordionGroup>
  <Accordion title="Edit User Details">
    Opens the user record where you can update full name, email address, contact number, assigned role, branch assignment, and location details.
  </Accordion>

  <Accordion title="Disable User">
    Deactivates the user's account and prevents login.

    Disabled accounts are retained for audit and record-keeping and can be viewed through **View Inactive Users**.
  </Accordion>
</AccordionGroup>

## Create a new user

<Steps>
  <Step title="Open Users">
    Go to **Configuration > User Roles and Permissions > Users**.
  </Step>

  <Step title="Click Add New User">
    Click **Add New User**.

    <Frame caption="Add New User button" />
  </Step>

  <Step title="Enter user details">
    Fill in identity, contact, login, role, branch, and optional location details.

    <Frame caption="Add New User form" />
  </Step>

  <Step title="Create the user">
    Click **Create User**. The account becomes active immediately.
  </Step>
</Steps>

## User detail fields

<AccordionGroup>
  <Accordion title="Identity and contact fields">
    <CardGroup cols={2}>
      <Card title="Full Name" icon="user">
        Required. User's full name as it appears in the system.
      </Card>

      <Card title="Email Address" icon="envelope">
        Required. Email address linked to the user account.
      </Card>

      <Card title="Contact Number" icon="phone">
        Required. User's phone number.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Login credential fields">
    <CardGroup cols={2}>
      <Card title="Use email as username" icon="envelope">
        Optional. Uses the email address as the login username automatically.
      </Card>

      <Card title="Username" icon="user">
        Required login username. Filled automatically if email-as-username is enabled.
      </Card>

      <Card title="Password" icon="key">
        Required initial login password for the user.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Role and branch fields">
    <CardGroup cols={2}>
      <Card title="Select Role" icon="user-shield">
        Required. Determines the user's permissions.
      </Card>

      <Card title="Select Branch" icon="folder-tree">
        Required. Controls the user's operational scope.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Location fields">
    Optional fields include location, city, state, and ZIP code.
  </Accordion>
</AccordionGroup>

<Info>
  User accounts become active immediately after creation. Share the username and password securely with the user so they can log in.
</Info>

## Key points

<CardGroup cols={2}>
  <Card title="Roles define permissions" icon="user-shield">
    Users inherit permissions from the role assigned to them.
  </Card>

  <Card title="Role changes are immediate" icon="bolt">
    Editing a role affects all users assigned to that role at once.
  </Card>

  <Card title="Branches limit scope" icon="folder-tree">
    Branch assignment controls which operational data a user can access.
  </Card>

  <Card title="Disabled users lose access" icon="ban">
    Disabling a user removes system access immediately.
  </Card>

  <Card title="Super Admin is fixed" icon="lock">
    The Super Admin role cannot be modified or disabled.
  </Card>

  <Card title="Unchecked means restricted" icon="circle-minus">
    Unchecked permissions are restricted, regardless of other settings.
  </Card>
</CardGroup>

<Warning>
  Restrict user configuration permissions to trusted administrators. Incorrect role or user changes can affect access across the entire workspace.
</Warning>
