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

# Quick Start

> Set up your organization, send your first task to the field and get the field app on your team's phones.

Follow these steps after you sign in for the first time. Each step links to the full guide for that page.

<Note>
  Required permission:

  * View hub, Create hub (step 1)
  * View user, Invite user, View role (step 2)
  * View flow, Create flow (step 3)
  * View task, Create task, Assign task (step 4)
  * View task, Do task (step 6)
</Note>

<Steps>
  <Step title="Create your hubs">
    A **hub** is a base your field team works from, such as a warehouse, office, depot or store. Every task, user and vehicle belongs to one or more hubs, so the hub is what keeps the work of each branch apart.

    You set up your first hub when you sign up. To add more, open **Settings › Hub** and click **New**. Give the hub a **Name**, search its **Address**, and check the pin on the map. See [Hub](/pages/settings/hub).
  </Step>

  <Step title="Invite your team">
    Open **Settings › User** and click **Invite**. Pick the **Hub** (or hubs) and the **Role**, type each email address and press **Enter**, then send the invitation. Everyone you invite in one go gets the same hubs and role.

    Give office staff the **Admin** or **Planner** role and field workers the **Field User** role. Each invited person gets an email with a link to set their name and password. See [Inviting Users](/pages/settings/user/inviting-users).
  </Step>

  <Step title="Design a task type">
    A **task type** is the form your field worker fills in, such as a delivery, a pickup or a visit. Open **Workflow › Task Type**, start from a template such as Delivery or Pickup, and change the fields to match how your team works. See [Task Type](/pages/workflow/task-type/introduction).
  </Step>

  <Step title="Create and assign tasks">
    Open **Activities › Task**, click **New**, choose the task type and fill in the details. Then pick a field worker in the **Assignee** column. You can also import many tasks from a spreadsheet. See [Creating a Task](/pages/activities/task/create-task) and [Assigning a Task](/pages/activities/task/assign-task).
  </Step>

  <Step title="Follow the work">
    The field worker sees the task on the field app. Follow them on **Monitoring › Tracking**, and open the task to see what they captured: data, photos and signatures. See [Tracking](/pages/monitoring/tracking/introduction).
  </Step>

  <Step title="Finish a task from the web (optional)">
    You don't always need the field app. When a task is assigned to you and is **Ongoing**, you can fill in its pages and finish it from the web app, for example for back-office work or to try out a task type. See [Doing a Task on the Web](/pages/activities/task/do-task).
  </Step>
</Steps>

## Who sees what: hubs

The hub a user belongs to decides which tasks, visits, vehicles and reports they see.

* The **hub picker** at the top of every page lists only the hubs you belong to.
* Lists such as tasks, visits and users show the hub selected in the picker. People without access to a hub never see its data.
* To change a user's hubs, edit the user on **Settings › User**. See [Managing Users](/pages/settings/user/managing-users).

If a hub is missing from your hub picker, ask your admin to add you to it.

## Get the field app

Your field team does its work on the field app. To get it, click the **?** button in the top bar and choose **Download the field app**.

<div align="center">
  <img src="https://mintcdn.com/mileappv4/WSCQrzxOhh4WLfZT/images/v4/getting-started/download-field-app.png?fit=max&auto=format&n=WSCQrzxOhh4WLfZT&q=85&s=7f28e30ba66fca49271b52ef66f49b35" alt="Download the field app" width="600" data-path="images/v4/getting-started/download-field-app.png" />
</div>

1. **Scan to download**: point the phone's camera at the QR code to open the store page.
2. **Google Play** and **App Store**: open the app in the store for Android or iPhone. Share these links with your field team.

Field workers sign in with the email and password they set when they accepted your invitation.

### Phone requirements

For the field app to run smoothly, phones should meet these requirements.

| | Android | iOS |
| - | - | - |
| **Minimum version** | Android 6.0 (Marshmallow) | iOS 14 |
| **Memory (RAM)** | At least 2 GB, 4 GB recommended | At least 2 GB, 4 GB recommended |

Allow the field app to use these on the phone:

1. **Camera**: for photo, video and capture fields.
2. **Location**: for tracking and for the coordinates saved with each task.
3. **Storage**: for photos and files the app keeps until they are uploaded.
4. **Phone**: for calling a customer from a task.

## Demo data

A new organization starts with a few demo tasks so you can try the app before you add your own. While every task in your hub is a demo task, a **DEMO DATA** banner shows at the top of every page:

* **New Task**: open **Activities › Task** and create your first task.
* **Delete Demo Data**: open **Activities › Task** and remove the demo tasks.
* **Tutorial**: open the guided tour below.

The banner goes away once you create your first real task or delete the demo data.

## Take the tour

Click your initials in the top right corner, then **Getting Started**. A short set of videos walks you through the main parts of the app. The number next to **Getting Started** shows how many of the videos you have finished, for example **(4/5)**.

<div align="center">
  <img src="https://mintcdn.com/mileappv4/WSCQrzxOhh4WLfZT/images/v4/getting-started/getting-started-tour.png?fit=max&auto=format&n=WSCQrzxOhh4WLfZT&q=85&s=381a63d2be48c60a0fd888b904ede77c" alt="Getting Started" width="600" data-path="images/v4/getting-started/getting-started-tour.png" />
</div>

1. **Course progress**: how many videos you have finished.
2. **Videos**: Task Management, Task Type Management, Real-time Tracking, Route Optimization and Automation. A tick marks each one you have watched. Click one to play it.
3. **Skip tutorial**: close the tour. You can open it again at any time from your profile menu.
4. **Next**: go to the next video. Watch the whole video to continue; **Previous** goes back one. On the last video, click **Finish**.

Below the video, **Replay** starts the video again and **Fullscreen** makes it fill the screen.

## What's next

* [Notifications and Help](/pages/getting-started/notifications-and-help): the bell, the help menu and the assistant.
* [Profile](/pages/account/profile): your name, photo, language and organizations.
* [Settings](/pages/settings/introduction): everything about your organization.


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