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

# Roles

<img src="https://mintcdn.com/hyra/_qr5ulpWZdIsRVbg/images/5fe7764c-4d08-4b44-84c9-d33197c49e1d.png?fit=max&auto=format&n=_qr5ulpWZdIsRVbg&q=85&s=ddb40b237010778c5a0d113b8579026a" className="rounded-xl" alt="Roles in Hyra" width="2736" height="1191" data-path="images/5fe7764c-4d08-4b44-84c9-d33197c49e1d.png" />

Roles allow you to give permissions to your team to access your workspace, create private categories in Knowledge Base, and many many more.

## Creating a Role

To create a role, follow the steps below:

<Note>
  To continue, you'll need the following permission: <b>Workspace Admin</b>
</Note>

<Steps>
  <Step title="Go to the Roles Page">
    Firstly, go to the Roles Page by going to Settings > Roles.
  </Step>

  <Step title="Create a Role">
    Click <b>Create Role</b> in the top and it should create a role named "new role".
  </Step>

  <Step title="Select Which Permissions to give.">
    After creating a role, you'll need to give it permissions. To give it permissions, just toggle the switch located on the right side of the permission.

    <Warning>In order for a staff to access the workspace, they must have at least <b>one</b> permission.</Warning>
  </Step>

  <Step title="Assign the Role to Your Staff! ">
    Once the permissions have been selected, scroll down until you see <b>Assigned Group Roles</b> and <b>Manual Members</b>.

    For <b>Asisgned Group Roles</b>, select which roles by switching the toggle on or off will recieve the role and its permissions. For <b>Manual Members</b>, you'll need to manually type their usernames and select from the dropdown.

    Be sure to hit <b>Save</b> to save your role!
  </Step>
</Steps>

### Administrative Permissions

Some permissions can cause harm to your workspace if given to a bad actor. Here's the list of all levels of permissions:

<Tabs>
  <Tab title="🟩 Basic Permissions">
    The permissions below can be given to everyone without harming your workspace:

    * View Workspace
    * Request timeoff
    * View Knowledge Library
    * View Orders
    * View Leaderboard

    **For Promotion Recommendation:**

    * View Promotions Recommendation
    * Create Promotion Recommendations
    * Upvote Promotion Recommendations

    <b>For Sessions:</b>

    * Assign Host to Self (for Hosts)
    * Assign Co-Host to Self (for Co-Hosts)
    * Create New Server (for Hosts and Co-Hosts)
    * Change Week on Calendar

    If you want the staff to access the workspace, enable <b>View Workspace</b>. This will also allow you to give more permissions to the staff.
  </Tab>

  <Tab title="🟨 Staff Permissions">
    The permissions below are usually reserved to your Human Resources Department or higher-ranking staff. We won't suggest giving these permissions to your staff.

    * View Other Staff
    * Manage timeoff Requests
    * View Logbook History
    * Post to Logbook
    * View Orders and Players Tab

    <b>For Sessions:</b>

    * Assign host to other people
    * Assign Co-Host to other people
    * Assign Roles to other people
  </Tab>

  <Tab title="🟥 Administrative Permissions">
    The permissions below are usually reserved to your Head of Human Resources and highest-ranking staff members. These permissions can cause harm to your workspace if given to a bad actor.

    * Update Knowledge Library
    * Edit Views
    * Add/Remove Minutes on Staff
    * Edit Staff Details
    * Delete Promotion Recommendations
    * Workspace Admin <Tooltip tip="This permission will grant them access to the workspace settings. Only give these to a certain people.">(dangerous permission)</Tooltip>
  </Tab>
</Tabs>

Please do note that it's up to you to decide whether they will gonna need the permission. These are only our suggestions to help you on deciding if a permission should be given to everyone, or to only a handful of people.

### Dependent Permissions

Some permissions are hidden because they are dependent to a parent permission. This means in order for them to be given, they will need their parent to be enabled first.

Below is the list of all parent permissions:

* View Workspace
* View Knowledge Library
* View Other Staff
* View Orders and Players tab
* View Promotions Recommendations
