> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/turn-equipment-on-or-off-and-manage-equipment.md).

# Turn Equipment on or off and manage your equipment

Equipment is the shared, returnable gear your business owns in limited numbers, such as lifts, ladders, and access keys. In **Settings → Equipment** you turn Equipment on and list each kind of equipment with how many units you own. You can tie equipment to the customers or properties that need it and have it added to their visits automatically. Schedulers can then add equipment to visits, Scheduling warns when a day needs more units than you own, and technicians see what to bring.

> **Where to find it:** Settings → Work Management → **Equipment**

## Before you start

You need the **Manage GPS & Scheduling Settings** permission to open this page. It stays available while Equipment is off, so an admin can always turn it back on.

## Turn Equipment on or off

1. Open **Settings → Equipment**.
2. Turn the switch at the top right of the page on (or off).
3. Select **Save**. Nothing changes until you save.

Turning Equipment off hides it everywhere: the visit form's **Equipment** field, capacity warnings on the Scheduling page, and equipment in the technician app. Your equipment list and the equipment already added to visits are kept, so turning it back on brings everything back.

The **Your Equipment** list appears once Equipment is on and saved.

## Add equipment

1. Under **Your Equipment**, select **Add Equipment**.
2. Enter a **Name**, such as Scissor lift.
3. Optionally add a **Description**: what the equipment is and when to bring it, for example "For ceilings over 12 ft. Needs two technicians." Up to 2,000 characters. Schedulers see it when adding equipment to a visit, and technicians see it on the visit in the mobile app.
4. Enter **Units owned**: how many of this item your business owns. Use a whole number from 0 to 9,999. Use 0 when no units are available, for example when every unit is out for repair. Any visit that needs it then shows a capacity warning.
5. Choose who it's **Associated with**:
   * **Any customer or property**: offered on every visit.
   * **Specific customers and properties**: pick any mix of customers (it applies at any of their properties) and properties (it applies only there). Pick at least one. It's offered only on visits for those customers and properties.
6. Optionally choose **Add to new visits automatically** (see below).
7. Select **Create**.

Add one entry for each kind of equipment, not one per unit. For example, add a single **Scissor lift** entry with **Units owned** set to 3.

## Add equipment to visits automatically

Use **Add to new visits automatically** so equipment a property always needs isn't forgotten, such as the 8' ladder for a restaurant's roof hatch:

* **Never**: schedulers add it to visits by hand.
* **Every visit**: it's added to every new visit for the customers and properties it's associated with (or to every new visit, if it's associated with any customer or property).
* **Visits of certain types**: pick one or more **Visit types**. It's added to new visits that include one of those types, where it's offered.

When equipment is added automatically, two settings decide whether schedulers can still add it by hand elsewhere:

* **Can also add to other customers and properties** (for specific customers and properties): turn it on to let schedulers add it to visits for any customer or property. It's still only added automatically and suggested for the ones you picked.
* **Can also add to other visit types** (for **Visits of certain types**): when off, schedulers can only add it to visits of those types. Turn it on to let them add it to visits of any type. It's still only added automatically to the visit types you picked.

If you own more than one unit, set **Units per visit** (a whole number, 1 or more) for how many units each visit gets. With one unit owned, each visit gets that one.

Automatic equipment is added when a visit is created: in the visit form, from bulk visit creation, from tasks, from the technician app, and by the assistant. In the visit form it appears in the **Equipment** field as soon as you pick the property and visit types, and you can remove it or change the quantity before saving. Editing an existing visit adds it only if you change the visit's property or visit types.

### Add it to visits already scheduled

When an automatic rule matches upcoming visits that don't have the equipment yet, the form shows **Also add to N upcoming visits**. Turn it on before you save to add the equipment to those visits too. Upcoming visits are unscheduled visits and visits from today forward that aren't complete or cancelled. Leave it off to apply the rule to new visits only.

The customer and property searches list active customers and properties only. If a customer or property is made inactive later, its equipment is no longer offered on visits. To use that equipment elsewhere, edit it and choose a different association.

The list shows each entry's **Name**, **Units Owned**, **Associated With**, **Auto-Add**, and **Can Also Add To**. Each entry's description, if it has one, shows in gray under its name (up to two lines). Long values in the other columns are cut off to one line and have a dotted underline; hover over one to read all of it. Select a column header to sort by it.

## Edit equipment

1. Select the edit icon on the equipment's row.
2. Change the **Name**, **Description**, **Units owned**, **Associated with** choice, automatic setting, or the **Can also add to…** settings. Clear the description to remove it. To remove one customer or property, click the **×** on it.
3. Select **Save**.

A new name or description shows wherever the equipment appears, including visits that already have it. Changing **Units owned** updates capacity warnings right away.

Customers or properties made inactive after you picked them show **(inactive)**; the equipment is no longer offered there. If Essential says a customer, property, or visit type you just picked is no longer active, remove it and select **Save** again.

## Archive equipment

1. Select the trash icon on the equipment's row.
2. Select **Archive** to confirm.

Archived equipment is removed from your list and can't be added to more visits. Visits that already have it keep it, but it no longer counts toward capacity warnings. Archiving can't be undone; to use the same gear again, add it as new equipment.

To learn how schedulers add equipment to a visit and how capacity warnings work, see [Add equipment to a visit](https://learn.withessential.com/customers-and-work/scheduling/add-equipment-to-a-visit.md).

## Related guides

* [Add equipment to a visit](https://learn.withessential.com/customers-and-work/scheduling/add-equipment-to-a-visit.md)
* [Set up inventory locations and suppliers](https://learn.withessential.com/administration/settings/set-up-inventory-locations-and-suppliers.md)
* [Turn scheduling and GPS features on or off](https://learn.withessential.com/administration/settings/turn-scheduling-and-gps-features-on-or-off.md)
* [Feature availability and setup](https://learn.withessential.com/getting-started/getting-started/feature-availability-and-setup.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.withessential.com/administration/settings/turn-equipment-on-or-off-and-manage-equipment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
