# Equipment & Tools

Set up your equipment register, hand units out and take them back, keep maintenance and repairs on track, and check that people still have their equipment.

Equipment & Tools keeps every vehicle, trailer, machine and tool you own in one list, with where each one is now and who last had it. At Granite Peak Outdoors, the yard manager can see that a trimmer is on the trailer behind a crew lead's truck, and that the skid steer is due for service at 250 hours.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

The module adds these pages under **Equipment & Tools** in the sidebar:

- **Equipment**: the register. Tiles count units **In service**, **In the shop**, **Missing**, **Out of service**, **To check**, **Papers due** and **No photo**; click one to show only those, and again to show all. Click a unit to open its **Overview**, **Maintenance**, **Photos**, **Documents** and **History**.
- **Maintenance**: what is **Due** by date, hours or miles, open **Repairs**, and the **Work log**.
- **Checks**: confirm a person, vehicle, location or crew still has its equipment.
- **Reports**: ready-made **Equipment list**, **Truck equipment** and **Salvaged vehicles** reports.

## Set it up

A Workspace Admin does this first.

1. Add your yards and shops under **System Settings → Locations**. See [Locations](article:ad414908-b91f-499a-92ab-8333ae1cd330).
2. Open **Module Settings** from the ⋮ on the **Equipment & Tools** sidebar row. Review the **Equipment types** it starts with. Click a type to set its details, meter (**Hours**, **Miles** or **None**) and maintenance, or click **Add type**.
3. On the **Preferences** tab, set when work counts as due soon (14 days or 10% by default), how many days ahead registration and insurance count as due (30), where people come from if you have more than one employee module, and whether nameplate photos are read with AI.
4. For nameplate reading and the assistant, add the workspace's own Anthropic key in **System Settings → AI Providers**, or untick **Read nameplate photos with AI**.
5. Give the permissions to your own roles, such as Crew Lead or Mechanic. Only the standard Admin, Operator and Viewer roles get them automatically. See [Users and roles: roles and permissions](article:888a2a90-7990-4ea5-a58e-af06f56b1bfd).
6. On **Equipment**, click **Add equipment** for each unit, or load a spreadsheet through the assistant. See [Import records from a spreadsheet or photo](article:a36da3c0-bc59-4ecf-a970-29e3555ffc3a).
7. Print and stick on a QR label for each unit (see below), and link chargeable machines to their Price Book rates.

## Add a unit

1. On **Equipment**, click **Add equipment**.
2. Pick the **Type**. Leave **Unit number** empty to get the next free number.
3. Fill in the **Name**, and the **Make**, **Model**, **Year** and **Serial number or VIN** if you have them.
4. Pick the **Home location**, and fill **Hour meter now** or **Odometer now (miles)** for a unit with a meter.
5. Click **Add**. The unit opens so you can add photos and details.

To fill the details from a nameplate, VIN sticker or registration, click **Add nameplate photo** on the unit's **Nameplate** card. For people who manage the equipment list, AI reads it (or click **Read with AI**). Click **Review and save**, check each value, and click **Save**. **Discard** throws the reading away.

## Hand out, move and return equipment

1. On **Equipment**, search for the unit and click it.
2. Click **Issue or move**. Under **Give it to**, pick **Person**, **Vehicle or trailer** or **Location** (and **Project** or **Customer** when another module provides them). Click the box or type to search, and choose one.
3. Enter the hours or miles, **Condition** and a note if you have them. Click **Save**.
4. When it comes back, click **Return**, pick the **Location**, enter the reading and click **Return**.
5. If it came back damaged, click **Note or condition**, set the **Condition** and write what happened.

To move several units, tick them and choose **Assign equipment…** from **Actions**.

## Record hours or miles

1. Open the unit and click **Hours** (or **Miles**). The button shows only for units with a meter.
2. Type **Reading now** and a note if it helps, then click **Save**.
3. If the reading is lower than the last one, **Lower reading** asks you to confirm. Save it only if the meter was replaced or reset.

Readings also come from hand-outs, returns, checks, logged work and field forms. To find units with no reading, open **Maintenance**, stay on **Due** and pick **No reading**.

## Change a unit's status

1. Open the unit and pick the new status in the **Status** list: **In service**, **In the shop** or **Missing**. Managers also see **Out of service** and **Retired**.
2. Click **Note or condition** and write why.

For many units, tick them on **Equipment** and pick **Actions → Mark in service**, **Mark in the shop**, **Mark missing** or **Mark out of service**, or **Change status…** to choose a status and write **Why**. **Retire…** takes units that are gone off the list.

## Keep maintenance and repairs on track

1. Plans for a whole type are set in **Module Settings**: click the type and **Add maintenance**. For one unit, open its **Maintenance** tab and click **Add maintenance**.
2. Name the **Work**, fill **Every … days** and/or **Every … hours** (or miles), add **Instructions**, and click **Save**. Whichever comes first makes it due. Click a plan's pencil to change it or untick **Active**; **Remove** deletes it.
3. Open **Maintenance**. **Due** lists what is overdue or due soon. When work is done, click the check mark (**Log work**) at the end of its line. For work that isn't on a plan, click **Log work** at the top, pick the **Unit**, click **Next** and say **What was done**.
4. Enter the **Date**, reading, **Cost** and **Notes**, then click **Save**. The next due counts from this job.
5. To report a fault, click **Report a problem** on the unit, or at the top of **Maintenance** and pick the **Equipment**. Fill in **What is wrong**, **Details**, **How urgent** and **Needed by**. If it is unsafe, tick **Take it out of use (In the shop)**, then click **Report**.
6. On **Repairs** (urgent and high first), click the check mark (**Complete**) on a line when it is fixed, fill the date, reading, **Cost** and **Notes**, and click **Save**. If the unit is in the shop, leave **Back in service (when no other repair is open)** ticked.
7. To drop a repair, open the **…** on its line and pick **Cancel repair**, or tick several and use **Actions → Cancel repairs…**.

Open **Work log** and set a date range to review what was done.

## Check equipment and inspect by scanning

1. On **Checks**, click **Check my equipment** (shown when you are on the employee list), or **Start a check**.
2. Under **Check the equipment of**, pick **Person**, **Vehicle or trailer**, **Location** or **Crew**, choose one, and click **Start**.
3. For each unit, choose **Have it**, **Missing** or **Not with them**. Set **Condition**, the reading, a **Note** or a **Photo** where needed.
4. Click **Add a unit they have** for anything found that isn't listed.
5. Click **Submit check**, add notes and click **Submit**. Missing units are flagged on the register, and poor or damaged ones get a repair. **Discard** throws away a check started by mistake.

For phone walk-arounds:

1. In **Inspections & Forms → Forms**, open the form and on **Settings** set **Start by scanning:** to Equipment & Tools → Equipment.
2. On **Design the form**, add **Equipment hours**, **Problems found**, **Maintenance done** and **Equipment photos**, then click **Save draft** and **Publish**.
3. Crews scan the unit's QR label in DV Field to start it. Problems they report appear on **Maintenance → Repairs**, and the form on the unit's **History**. See [DV Field mobile app](article:619f57f8-8632-4cb0-82dd-b08ba16ccfea).

## Print QR labels

1. On **Equipment**, tick the units you want. Tick none to label every unit shown.
2. Click **QR labels** at the top (or **Actions → QR labels**). For one unit, click **QR label** on its **Details** card.
3. Pick the **Label stock**, tick or untick **Equipment name under the number**, add a **Company line**, and set **Skip** on a part-used sheet.
4. Click **Print** (or Save as PDF in the print dialog), or **CSV for a label printer** for your label software.

## Photos, papers and reminders

1. On the unit's **Photos** tab, click **Add photo**, then **Make main** on the best one.
2. On **Documents**, click **Add document**. Choose the file, pick the **Type**, fill **Expires on** for a registration, insurance card or warranty, and click **Add**.
3. The **Papers due** tile on **Equipment** lists units whose registration or insurance is due or expired. People who manage equipment get a notification before it lapses and again when it does.

## Details to check

1. When the sheet, the photo and the plate disagree, open the unit and click **Flag a detail**.
2. Fill **What to check** and, if you have them, **What the sheet says**, **What the photo or label says** and **What we recorded**. Click **Flag it**.
3. Once the plate has been read, click the check mark on the row, write **What was found** and click **Resolve**. Correct the unit with **Edit** on **Details** if it was wrong.

The **To check** tile lists every unit with an open detail to check.

## Link a unit to its Price Book rates

1. Open the unit and, on the **Rates** card, click **Link a rate**.
2. Pick **Operated equipment** or **Equipment rental**, and search the Price Book. Tick **Also for every other …** to link every unit of the type.
3. Click the rate it bills at. Link more if it has them.
4. If the rate isn't there, fill **Not there? Create the rate in the Price Book** (name, **Per**, **Sell price**, **Minimum**, **Internal cost**) and click **Create and link**.
5. To stop billing at a rate, click the × on it and confirm **Unlink rate**.

## Sold or total loss

1. Open the unit and, on the **Details** card, click **Sold or total loss**.
2. Pick **Sold** or **Total loss**, and fill the **Date**, **Sold to, or the insurer** and the **Amount**.
3. Leave **Free … for a new unit** ticked to reuse the number, then click **Save**. The unit is retired.
4. To undo, tick **Retired only** on **Equipment**, open the unit and click **Take back**.

Tick **Salvaged** when editing a unit with a salvage title; the **Salvaged vehicles** report lists them.

## History, reports and exports

1. Open the unit's **History** tab. Narrow it with **Assigned and moved**, **Status**, **Hours and miles**, **Maintenance and repairs**, **Equipment checks**, **Forms and inspections**, **Used on projects**, **Notes and photos** or **Added and edited**. Click **Open form ›** to read a form.
2. For several units, tick them on **Equipment** and pick **Actions → View history**.
3. Click **Export to Excel** to download the whole register. Yellow cells are missing details; red unit numbers have a detail to check.
4. Tick rows and use **Actions → Export selected to CSV**. Maintenance and Checks have the same export.
5. Open **Reports**, and under **Ready-made** click **Equipment list**, **Truck equipment** or **Salvaged vehicles**. Give it a **Report name**, click **Create report**, then **Print / Save as PDF**.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View equipment** | See every unit, its details, photos and history and who has it; check their own equipment; see maintenance due; report a problem; print QR labels and export lists. | Admin, Operator, Viewer |
| **View equipment costs** | See what units cost to buy and repair: purchase costs, repair and maintenance costs, sale or insurance amounts, and the cost reports. | Admin |
| **Check equipment in and out** | Issue, return and move units; record hours or miles, condition and notes; mark units in service, in the shop or missing; add photos; flag details to check; run equipment checks on anyone. | Admin, Operator |
| **Manage the equipment list** | Add and edit units and equipment types, set maintenance plans, read nameplates with AI, link Price Book rates, file documents, mark units out of service, retired, sold or a total loss, delete photos, and load equipment in bulk through the assistant. **Give with care.** | Admin |
| **Log maintenance and repairs** | Log maintenance work, and complete or cancel repairs. | Admin, Operator |

- Anyone who can check equipment in and out can add a nameplate photo. Reading it with AI, and the automatic reading after the photo, happen only for people who can manage the equipment list, and only while **Read nameplate photos with AI** is on.
- The **Sold or total loss** button needs Manage the equipment list. Its **Amount** field shows only to people who also have View equipment costs.

## Ask its agent

The **Equipment & Tools Assistant** works with your register. Try:

- "Here is our equipment spreadsheet. Load it into the register."
- "Find the unit with VIN ending 4471."
- "How many units are in the shop?"
- "Add this photo to TRK-012."

It shows a preview and saves only after you say yes. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48).

## Good to know

- **Read with AI** fills in a unit's details from a nameplate photo. It uses your workspace's own AI key.
- Units are never deleted. **Retire…** takes one off the list; tick **Retired only** to see them. Retired units have no Issue, Return, Hours or Status buttons.
- People come from your HR module, or your workspace's users if you have none. Projects and customers appear only if another module provides them.
- Prices stay in the Price Book. Seeing them needs the Price Book's *View prices*, and creating a rate needs its *Manage*.
- Without **View equipment costs**, cost columns and fields stay empty.

## More help

Open the module's **Help** for the full reference, and its **Runbooks** for step-by-step guides. See [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522). Equipment & Tools works with Inspections & Forms for scanned inspections, Price Book & Vendors for rates, and your HR module for people.


Source: https://datavisions.ai/docs/module-guides/equipment-tools
