> 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/basics/custom-fields-your-businesss-extra-fields-on-records.md).

# Custom fields: your business's extra fields on records

Custom fields are extra fields your business defines to capture information Essential doesn't have a built-in field for. Each custom field has a name and a type (text, yes/no, or a list of choices), is tied to a kind of record (a customer, property, asset group, or job), and can be marked required.

They're set up for your business ahead of time; then back-office users fill in their values on each record's Custom Fields card — on the customer page, the property page, an asset group, or a job — using Edit. Admins can also make selected customer, property, and asset group fields visible to technicians in the mobile visit details, with a separate option to let technicians edit the value. The create/edit visit form automatically shows every non-empty Customer and Property custom-field value in its Additional Context panel, alongside the editable Job custom fields.

So if you don't see a built-in place for a piece of information you want to track, a custom field is how your business adds one. Admins can add and manage these fields themselves in [Settings → Custom Fields](/administration/settings/create-and-manage-custom-fields.md), including making a field required or requiring unique values.

> **Where to find it:** The Custom Fields card on a customer, property, asset group, or job; Edit to fill them in. Admins define the fields in Settings → Custom Fields.

## Related guides

* [Create and manage custom fields](/administration/settings/create-and-manage-custom-fields.md)
* [See the Custom fields report](/reporting-and-integrations/reporting/custom-fields-report.md)
* [Custom pricing: a special price for an item, per customer or property](/administration/basics/custom-pricing-a-special-price-for-an-item-per-customer-or-property.md)
* [How recurring service automation works (the full cycle)](/administration/how-recurring-service-automation-works-the-full-cycle.md)
* [The property-access form your customers fill out to approve, deny, or redirect upcoming work](/administration/what-your-customers-see-in-the-customer-portal/the-property-access-form-your-customers-fill-out-to-approve-deny-or-redirect-upcoming-work.md)
* [What "Awaiting Service Completion" means and how it clears](/administration/how-recurring-service-automation-works-the-full-cycle/what-awaiting-service-completion-means-and-how-it-clears.md)
* [What a service completion is and how it's recorded](/administration/how-recurring-service-automation-works-the-full-cycle/what-a-service-completion-is-and-how-its-recorded.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.withessential.com/administration/basics/custom-fields-your-businesss-extra-fields-on-records.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.