> ## Documentation Index
> Fetch the complete documentation index at: https://docsy3.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)

## The Permission page

![Permission page](https://mintcdn.com/mile-app/WPibWyW63U4l5gcF/images/v4/settings/permission.png?fit=max\&auto=format\&n=WPibWyW63U4l5gcF\&q=85\&s=c7ef7ada6c7b23771e6832abe969a8f3)

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](https://docsy3.mile.app/pages/settings/permission/managing-roles.md).
3. **Search permissions**: find a permission by name. The page shows only the sections that match, and the switch in a card's header then turns on or off only the permissions shown.
4. **Permission groups**: the permissions of the selected role, arranged the way the menus are. One list of cards in two columns, one card per menu (Analytics, Planning, Monitoring and so on, with **Advanced** and **Custom** last), and each card holds one section per submenu. On a small screen the cards stack in a single column in the same order. Every card starts open and shows how many of its permissions are on, for example *4 of 4 on*. The switch in a card's header turns the whole card on or off. Click the arrow to fold a card. A permission or section with an **i** icon beside it has a short explanation; hover over or focus the icon to read it. See [Permission Reference](https://docsy3.mile.app/pages/settings/permission/permission-reference.md) for where each permission sits.
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 › Configure**: hide chosen fields of a flow from this role. See [Restricted Fields](https://docsy3.mile.app/pages/settings/permission/restricted-fields.md).
* **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 flow**: limit which flows this role can create tasks of. Leave it on *Every flow* to allow all.
* **View data source › Configure**: hide chosen fields of a data type from this role.
* **Start Trip - End Trip**: how the field app tracks location, and how far from the hub a trip may start and end. See [Access and Sign-in](https://docsy3.mile.app/pages/settings/permission/access-and-sign-in.md).

![Task permission settings](https://mintcdn.com/mile-app/WPibWyW63U4l5gcF/images/v4/settings/permission-task.png?fit=max\&auto=format\&n=WPibWyW63U4l5gcF\&q=85\&s=8139033af9e5aca1f54516d7743e2b89)

1. **Only my task**: limits the list to the user's own tasks.
2. **Configure**: opens the restricted fields editor for flows.
3. **Every flow**: the flows 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](https://docsy3.mile.app/pages/settings/permission/managing-roles.md)
* [Permission Reference](https://docsy3.mile.app/pages/settings/permission/permission-reference.md): every permission and what it allows.
* [Restricted Fields](https://docsy3.mile.app/pages/settings/permission/restricted-fields.md)
* [Access and Sign-in](https://docsy3.mile.app/pages/settings/permission/access-and-sign-in.md): multi-factor authentication, device limit, mobile-only access and location tracking.


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