> For the complete documentation index, see [llms.txt](https://kitehouse.co.uk/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kitehouse.co.uk/docs/admin/settings/roles.md).

# Roles

Roles allows you to customise the permission level given to your staff members. You can assign roles to your staff members using the Staff tab.

<figure><img src="https://3602476689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpWzphhnllUlrdiqcsZC%2Fuploads%2FMAD1gCmOqWMNhsG29Bb9%2FKitehouse%20Docs(2).png?alt=media&amp;token=e7f9aef0-3377-41fc-ab0f-a7d0e9afa1ae" alt=""><figcaption></figcaption></figure>

## Creating a Role

To create a role, follow the steps below:

{% stepper %}
{% step %}

### Go to the Roles Tab

You can do this by going to **Site Settings** then selecting the **Roles** section on the sidebar.
{% endstep %}

{% step %}

### Create a Role

Click **Create Role** to create a new role. Click the newly-created role to expand it's options.\
\
Once expanded, you can change the name of the role, will they require email login and the permissions given to them.
{% endstep %}
{% endstepper %}

### Permission Details

{% tabs %}
{% tab title="Incident Tab" %}
These are the permissions that you may give out to your staff members that creates incidents.

<table><thead><tr><th width="236">Name of Permission</th><th>Description</th></tr></thead><tbody><tr><td>Incident View</td><td>Allows them to view the Incident Page.</td></tr><tr><td>Incident View Own</td><td>Allows them to only view the incidents assigned to them.</td></tr><tr><td>Incident Create</td><td>Allows them to create incidents.</td></tr><tr><td>Incident Edit</td><td>Allows them to edit incident details.</td></tr><tr><td>Incident Close</td><td>Allows them to close incidents.</td></tr><tr><td>Incident Delete*</td><td>Allows them to delete incidents.</td></tr><tr><td>Incident Assign</td><td>Allows them to assign incidents to staff members.</td></tr><tr><td>Incident View Sensitive</td><td>Allows them to view sensitive incidents.</td></tr><tr><td>Incident Export</td><td>Allows them to export incidents.</td></tr><tr><td>Comment Create</td><td>Allows them to create comments.</td></tr><tr><td>Comment Delete Own</td><td>Allows them to delete their own comments.</td></tr><tr><td>Comment Delete Any*</td><td>Allows them to delete any of the comments in an incident.</td></tr><tr><td>Attachment Upload</td><td>Allows them to upload attachments in an incident.</td></tr><tr><td>Attachment Download</td><td>Allows them to download the attachments linked to an incident.</td></tr><tr><td>Attachment Delete</td><td>Allows them to delete attachments linked to an incident.</td></tr></tbody></table>

**Please Note:** Permissions with an **asterisk (\*)** can be abusive.
{% endtab %}

{% tab title="Student Tab" %}
These are the permissions that allows your staff members to have access to student data.

<table><thead><tr><th width="210">Name of Permission</th><th>Description</th></tr></thead><tbody><tr><td>Student View</td><td>Gives them access to the Student tab.</td></tr><tr><td>Student Create</td><td>Allows them to create a student in Kitehouse.</td></tr><tr><td>Student Edit</td><td>Allows them to edit the information regarding a student.</td></tr><tr><td>Student Delete*</td><td>Allows them to delete students stored in Kitehouse.</td></tr><tr><td>Student Import</td><td>Allows them to import student data to Kitehouse.</td></tr><tr><td>Student Export</td><td>Allows them to export student data out of Kitehouse.</td></tr></tbody></table>

**Please Note:** Permissions with an **asterisk (\*)** can be abusive.
{% endtab %}

{% tab title="Other Permissions" %}
These are other permissions that allows your staff to access different tabs in Kitehouse.

<table><thead><tr><th width="243">Name of Permission</th><th>Description</th></tr></thead><tbody><tr><td>Dashboard View</td><td>Gives them access to the Dashboard tab.</td></tr><tr><td>Audit View</td><td>Gives them access audit history in an incident.</td></tr><tr><td>Staff Manage*</td><td>Allows them to add/remove staff members.</td></tr><tr><td>Settings Manage*</td><td>Allows them to manage Site settings.</td></tr><tr><td>Quality Gates Manage</td><td></td></tr><tr><td>Governance View</td><td>Gives them access to the Governance View</td></tr><tr><td>Governance Export</td><td>Allows them to export reports from the Governance View.</td></tr></tbody></table>

**Please Note:** Permissions with an **asterisk (\*)** can be abusive.
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://kitehouse.co.uk/docs/admin/settings/roles.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
