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

# Permission

> Roles decide what each person can see and do. Choose a role and turn its permissions on or off.

Every user has one **role**, and each role carries a set of **permissions**. **Settings › Permission** is where you decide what each role can see and do.

<Note>
  Required permission:

  * View permission
  * Edit permission (to make changes)
</Note>

## The Permission page

<div align="center">
  <img src="https://mintcdn.com/mileappv4/Xul_B0hUk35UiMLk/images/v4/settings/permission.png?fit=max&auto=format&n=Xul_B0hUk35UiMLk&q=85&s=746f21154e2be92c792e07647c0be15e" alt="Permission page" width="600" data-path="images/v4/settings/permission.png" />
</div>

1. **Roles**: every role in your organization. Click one to load its permissions. Use **Search roles** to find a role.
2. **New**: create a role. See [Managing Roles](/pages/settings/permission/managing-roles).
3. **Search permissions**: find a permission by name. The page shows only the groups that match.
4. **Permission groups**: the permissions of the selected role, grouped by area (Dashboard, Task, Task Schedule and so on). Each group shows how many of its permissions are on, for example *4 of 4 on*. The switch in a group's header turns the whole group on or off. Click the arrow to fold a group.
5. **Discard / Save**: changes take effect only when you click **Save**. **Discard** throws them away. If you pick another role with unsaved changes, the app asks whether to discard them.

If you can view permissions but not change them, the page says *You can view these permissions but not change them.*

## Built-in roles

Every organization starts with built-in roles that fit the most common jobs. You can change their permissions and add your own roles beside them.

| Role | Designed for |
| - | - |
| **Owner** | The organization's owner. Has every permission and is the only role that can delete the organization. There is always exactly one owner, and the role can't be deleted, renamed or switched off. |
| **Admin** | Managing users, configuring permissions and running the application day to day. |
| **Planner** | Organizing tasks, planning routes and coordinating field activities. |
| **Field User** | Field workers who view and do the tasks set by planners or admins, mostly on the field app. |

### What only an owner can do

* Invite someone as an owner, or change someone's role to Owner.
* Change another owner's role, name, phone number, hubs or teams.
* Reset another owner's password.
* Delete an owner (by transferring ownership first).

## Permissions with extra settings

Some permissions have settings of their own that appear when the permission is on:

* **View task › Restricted fields › Configure**: hide chosen fields of a task type from this role. See [Restricted Fields](/pages/settings/permission/restricted-fields).
* **View task › Show only my task**: people with this role see only the tasks assigned to them. When off, they see every task in their hubs.
* **Create task › Every task type**: limit which task types this role can create tasks of. Leave it on *Every task type* to allow all.
* **View data source › Restricted fields**: hide chosen fields of a data type from this role.
* **Location Tracking**: how the field app tracks location, and how far from the hub a trip may start and end. See [Access and Sign-in](/pages/settings/permission/access-and-sign-in).

<div align="center">
  <img src="https://mintcdn.com/mileappv4/Xul_B0hUk35UiMLk/images/v4/settings/permission-task.png?fit=max&auto=format&n=Xul_B0hUk35UiMLk&q=85&s=249faab57d348bd8e174b404f911f9fd" alt="Task permission settings" width="600" data-path="images/v4/settings/permission-task.png" />
</div>

1. **Show only my task**: limits the list to the user's own tasks.
2. **Configure**: opens the restricted fields editor for task types.
3. **Every task type**: the task types this role may create tasks of.

## When a permission is missing

When someone opens a page or clicks an action their role doesn't allow, the app blocks it and shows a message such as *You don't have permission to access this page. Contact your admin to go further.* Note what you were trying to do and ask an owner or admin to turn on the matching permission.

## In this section

* [Managing Roles](/pages/settings/permission/managing-roles)
* [Permission Reference](/pages/settings/permission/permission-reference): every permission and what it allows.
* [Restricted Fields](/pages/settings/permission/restricted-fields)
* [Access and Sign-in](/pages/settings/permission/access-and-sign-in): multi-factor authentication, single login, mobile-only access and location tracking.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.