> 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/reporting-and-integrations/reporting/custom-fields-report.md).

# See the Custom fields report

The Custom fields report shows how a custom field's values are spread across your records — how many records hold each value, and which records those are. It's the quickest way to audit a field: spot typos and duplicates, see how often a value is used, or find every record with a particular value.

> **Where to find it:** Reports → Custom fields

**Before you start:** you need at least one custom field defined. See [Create and manage custom fields](/administration/settings/create-and-manage-custom-fields.md).

## Read the report

1. Pick a field from the dropdown at the top (fields are listed alphabetically, with the record type they apply to).
2. The summary shows **Records with a value**, the number of **Distinct values**, and the **Field type**.
3. The table lists each value with:
   * **Value** — the stored value.
   * **Records** — how many records have that value.
   * **% of valued** — that value's share of all records that have any value.

Counts reflect live records only — deleted records aren't included, and each record is counted once.

## Find a value

Type in the **Search values** box to narrow the list. Search looks across every value for the field, not just the ones currently on screen, so you can find a value even when the field has thousands of distinct entries.

## See which records use a value

Click a **value** to open a list of the records that hold it. Each record links straight to its page, so you can jump in and review or fix it. For values shared by a very large number of records, the list shows the first 2,000.

## Export

Use the download button to export the current distribution as a CSV.

## Related

* [Create and manage custom fields](/administration/settings/create-and-manage-custom-fields.md)
* [Export, filter, and drill into a report](/reporting-and-integrations/reporting/export-filter-and-drill-into-a-report.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/reporting-and-integrations/reporting/custom-fields-report.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.