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

# What is free on the handset

> The availability calendar on the handset — assets, tools, places and people by class and by day, what is holding a day, and booking what is free.

**What is free** answers "is there an excavator free on the fourteenth" from the yard gate: it shows what your organisation books, by class and by day, read live from the same calendar the planner at a desk is looking at, and lets you book a free asset from it.

> [!NOTE]
>
> If you don't see **Bookings** on Home, your administrator can switch the module on under **Administration → Modules**, or it may not be included in your plan. You also need permission to see bookings. Booking from this screen needs permission to make bookings.

Open it from [Bookings](https://docs.assetinfinity.ai/field/bookings.md) with the calendar button beside the heading. The heading says **By class and by day, read live.** **← Bookings** goes back, and the refresh button reads the calendar again. The web app's version is described under [bookings](https://docs.assetinfinity.ai/assets/bookings.md).

## Choosing what to look at

| Control | What it does |
| - | - |
| **Assets**, **Tools**, **Places**, **People** | Which kind of thing the calendar shows. Only the kinds your organisation books are offered, and the buttons are left out where it books only one |
| **Category** (for assets) or **Type** | Narrows the calendar to one class and what is filed under it. **Every category** or **Every type** shows them all |
| **Site** | Narrows it to one site, or **Every site**. Starts at the site picked in the header's site filter where one site is picked there, otherwise at the site you are **Based at** |
| **Code or serial number** (for assets and tools) or **Code** | Finds a machine by part of its code or serial number, even inside a class you have not opened. Narrows nothing until you have typed two characters. **Nothing here matches "{search}"** when nothing does |
| The month | The arrows move a month back or forward. Tap the month's name to come back to this month |

![What is free on the handset, a month of asset categories with the number free each day](https://mintcdn.com/assetinfinity/XmUe8EES1aV81mDD/images/field/availability-light.png?fit=max\&auto=format\&n=XmUe8EES1aV81mDD\&q=85\&s=74366f8b2366d11bb591feb7e1b14dd8)

If your organisation has nothing set up to be booked yet, the screen says **Nothing is set up to be booked here yet**.

## Reading the calendar

The calendar is a table of classes down the side and the month's days across the top. The days scroll sideways while the class names stay where they are; today's date is highlighted and weekends are shaded.

Each class's day shows how many of that class are free all day, coloured by how much is left:

| Colour | What it means |
| - | - |
| **all free** | Everything in the class is free that day |
| **some out** | Some of it is booked or unavailable |
| **few left** | Only a few are free |
| **none free** | Nothing in the class is free |

Tap a class's name to open it. Under it come the classes filed inside it, then each machine — its code and name — with a row of its own days. On a machine's row a held day is shaded **held** and shows the initials of the person it is held for, and a day it was booked and has since come back is shaded **returned**. A class with nothing directly under it says **Nothing is filed directly under this one**.

## What is on a day

Tap a day on any row to see what is on it. A panel opens below the calendar with the class or machine, the date, and **Everything in this class on the day** (or **This one, on the day** for a machine's row). Each line is a machine, place or person with its code, its name, its class and its state:

| State | What it means |
| - | - |
| **free** | Nothing holds it that day |
| **booked** (**taken** for a place, **committed** for a person) | A booking holds it. The line names the booking and its title — or **Issued without a booking** — with the window it is held for, **For {name}**, and **· overdue, still out** where it should have come back and has not |
| **returned** | It was booked that day and has already come back |
| **out of service**, **retired**, **maintenance falls due**, **calibration lapsed**, **not bookable** | Why an asset or tool is not on offer that day |
| **not in use**, **away**, **on leave** | Why a place or a person is not available that day |

Tap the same day again, or the cross, to close the panel.

### A span of days

After tapping one day, tap a second day on the **same row** to ask about every day between the two. The panel then says **Free for every day of the span** (or **Whether this one is free for every day** for a machine) and lists only what is free for the whole of it. If nothing is, it says **Nothing is free for the whole span. Tap a single day to see what is holding it.** On a handset with a mouse or pen you can drag across the row instead, as on the web.

## Booking from the calendar

Where you may make bookings and you are looking at assets, each free asset in the panel has **Book**, which opens [New booking](https://docs.assetinfinity.ai/field/new-booking.md) with that asset and the days you asked about. A span with more than one free asset also offers **Book all {count} together**, which puts all of them on one booking. A span that started in the past is booked from today, and a day already over offers nothing to book.

Tools, places and people are booked in the web app, as are several machines picked across classes into one booking and the calendar's export.

> [!NOTE]
>
> **What is free needs a connection.** It is read live, because it changes while you are on your way. Nothing is kept on the handset, so without a signal the screen says **Needs a connection** — **What is free is read live, because it changes while you are on your way. Nothing is kept on this device.** — and offers **Try again**.


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