# Roles & Permissions

FleetFusion uses a role-based access control system to manage what each user can see and do. Roles are collections of permissions, and users are assigned one or more roles. This gives you fine-grained control over who can access each area of the platform.

<figure><img src="/files/Ka8zUSm3DLki0IMuWDVn" alt=""><figcaption></figcaption></figure>

## Overview

Go to **Settings > Roles** to view and manage roles and their permission assignments. Each role defines a set of permissions that determine which pages, actions, and data a user with that role can access.

## How It Works

1. **Permissions** are defined at the system level, covering every area of FleetFusion.
2. **Roles** group permissions together (e.g. "Fleet Manager", "Driver", "Administrator").
3. **Users** are assigned one or more roles, and their effective permissions are the combined set of all assigned role permissions.

<figure><img src="/files/crrEv3xJxotg6Cgags7L" alt=""><figcaption></figcaption></figure>

## Permission Areas

| Area                                    | What It Controls                                               |
| --------------------------------------- | -------------------------------------------------------------- |
| **Dashboard**                           | Access to the actions dashboard and KPI widgets.               |
| **Vehicles**                            | View, create, edit, and delete vehicles.                       |
| **Drivers**                             | View, create, edit, and delete drivers.                        |
| **Work Items**                          | Access to the Work Queue and work order management.            |
| **Check List Submissions**              | View and manage walkaround check submissions.                  |
| **Service Tasks / Programs / Schedule** | Manage maintenance tasks, service routines, and schedules.     |
| **Documents**                           | Upload, review, approve, and manage documents.                 |
| **Reports**                             | View and run reports, manage scheduled reports.                |
| **Fleets**                              | Manage fleet groupings.                                        |
| **Cost Centers**                        | Manage cost centre records.                                    |
| **Vehicle Types**                       | Configure vehicle type definitions.                            |
| **Driver Types**                        | Configure driver type definitions.                             |
| **Suppliers**                           | Manage supplier records.                                       |
| **Workshops**                           | Manage workshop records.                                       |
| **Integration Configs**                 | Configure telematics and service provider integrations.        |
| **Tenant Settings**                     | Access to organisation settings and system-wide configuration. |
| **Admin**                               | Administrative functions including user and role management.   |

## How to Create a Role

1. Go to **Settings > Roles**.
2. Click **+ New Role**.
3. Enter the **Role Name**.
4. Select the permissions this role should grant.
5. Click **Save**.

## How to Assign a Role to a User

1. Go to **Settings > Users**.
2. Find the user and click **Edit**.
3. In the **Roles** section, select the roles to assign.
4. Click **Save**.

{% hint style="warning" %}
Be careful when granting **Admin** and **Tenant Settings** permissions. These allow users to change system-wide configuration and manage other users' access.
{% endhint %}

{% hint style="success" %}
Follow the principle of least privilege: give each user only the permissions they need to perform their role. Start with restrictive roles and add permissions as needed.
{% endhint %}

## Related Articles

* [Organisation Settings](/documentation/settings/organisation-settings.md)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/settings/roles-and-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.