> ## 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.

# Managing Briefs

> Add, edit and delete briefs, and choose which roles can see them.

Briefs are managed from **Workflow › Brief**.

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

## Add a brief

Click **Add Brief** on the Brief list.

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

1. **Name**

The brief's name, for example *SOP Servis Berkala 10.000 km*. Required, up to 100 characters, and unique in your organization: if another brief uses it, the dialog says so under **Name**. Briefs in Trash do not count.

2. **Type**

The document type. **PDF** is the only type today.

3. **Source**

Where the PDF comes from:

* **Link**: type the PDF's address in **URL**. It must start with `https://`.
* **Upload**: choose a PDF in **PDF file**. The file must be a PDF of at most 20 MB.

4. **Roles**

The roles that can see the brief. Choose one or more, or leave it empty so every role sees it. With two or more roles chosen, the field shows how many, for example **3 roles**.

Click **Save**. The brief appears at the top of the list.

> [!NOTE]
>
> **Add Brief** appears only for a role with **Create brief**.

## Edit a brief

Open the **⋯** menu at the end of a row and click **Edit**.

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

The dialog has the same fields as **Add Brief**. For an uploaded brief, **Current file** shows the PDF it holds:

* Leave **PDF file** empty to keep the current PDF.
* Choose a new PDF to replace it.
* Switch **Source** to **Link** to use a URL instead.

Click **Save**.

## Delete a brief

Open the **⋯** menu at the end of a row and click **Delete**, then confirm.

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

The brief disappears from the web and the mobile app at once and moves to **Settings › Trash**, where it stays for 30 days.

> [!NOTE]
>
> **Edit** appears only for a role with **Edit brief**, and **Delete** only for a role with **Delete brief**.

## Brief permissions

Set them in **Settings › Permission**, in the **Brief** section of the **Workflow** card.

![Brief permissions in Settings › Permission](https://mintcdn.com/mileapp-e5b5ea5a/YZyt_FynTfzjyDcR/images/v4/workflow/brief/permissions.png?fit=max\&auto=format\&n=YZyt_FynTfzjyDcR\&q=85\&s=5a75cc0715442176532a38d20da63acd)

| Permission | What it allows |
| - | - |
| **View brief** | Open **Workflow › Brief**. The page lists the briefs for the user's own role and the briefs for every role. |
| **Create brief** | Add briefs. |
| **Edit brief** | Edit the briefs the user can see. |
| **Delete brief** | Delete the briefs the user can see. |

Only the **owner** sees every brief. Every other role, admins included, sees the briefs for its own role and the briefs for every role, whatever Brief permissions it has.

Field users need no Brief permission to read their briefs in the mobile app.


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