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

# Introduction

> What a brief is, who can see it, and the Brief list.

A **brief** is a reference document your field team reads while they work, such as an SOP, a product guide or a campaign brief. Each brief is one PDF, either from a link or uploaded to MileApp, and you choose which roles can see it.

Field users open their briefs in the mobile app. Each user sees only the briefs shared with their role, plus the briefs shared with every role.

Open **Workflow › Brief**.

> [!NOTE]
>
> Required permission:
>
> * View brief
> * Create brief
> * Edit brief
> * Delete brief

## Who sees which brief

When you add a brief you pick its **Roles**:

* **Roles left empty**: every role sees the brief.
* **One or more roles**: only users with one of those roles see it.

Only the **owner** sees every brief. Every other role, admins included, sees the briefs for its own role and those for every role, on the web and in the mobile app alike. A brief limited to other roles cannot be opened, edited or deleted by them.

| User | Brief shared with *Mekanik* | Brief shared with every role |
| - | - | - |
| Owner | Sees it | Sees it |
| Admin with **Edit brief** | Does not see it | Sees it |
| Mekanik | Sees it | Sees it |
| Service Advisor | Does not see it | Sees it |

## The Brief list

![Brief list](https://mintcdn.com/mileapp-e5b5ea5a/YZyt_FynTfzjyDcR/images/v4/workflow/brief/list.png?fit=max\&auto=format\&n=YZyt_FynTfzjyDcR\&q=85\&s=2d854c4eb30d7ec73cbad4814e0ea136)

1. **Search brief**

Finds briefs by name.

2. **Add Brief**

Adds a brief. See [Managing Briefs](https://docs.mile.app/pages/workflow/brief/managing-briefs.md#add-a-brief).

3. **Brief row**

Click a row to open the brief's PDF in a new tab.

4. **Row menu (⋯)**

**Edit** or **Delete** the brief.

### Columns

| Column | What it shows |
| - | - |
| **Name** | The brief's name, for example *SOP Servis Berkala 10.000 km*. |
| **File** | The name of the uploaded PDF, as a link that opens it. Shows **—** for a brief that comes from a link. |
| **Type** | The document type. Always **PDF** today. |
| **Source** | **Link** or **Upload**. |
| **Role** | The first role that can see the brief, with **+N more** for the rest (hover it to see their names). **All roles** when the brief is shared with every role. |
| **Created at** | The date and time the brief was added. |
| **Updated at** | The date and time of the last change. |

The list shows 20 briefs per page, newest change first. When there are none yet, the page shows **No briefs yet**.

> [!NOTE]
>
> Briefs are shared by the whole organization, so the hub picker in the header does not filter this page.

## Next steps

* [Managing Briefs](https://docs.mile.app/pages/workflow/brief/managing-briefs.md): add, edit and delete briefs, and the Brief permissions.


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