> ## Documentation Index
> Fetch the complete documentation index at: https://help.fieldpulse.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Setting Up Custom Fields on Purchase Orders
> Add line-item custom fields to purchase orders in FieldPulse to track item status, arrival dates, and condition, then report on them across your orders.
> **Who uses this:** Admins create line item custom fields in **Company Settings** (a section only the Administrator role can view) and choose which roles see each field; the team members you give access to fill the fields in on a purchase order. **Availability:** All regions. Purchase Orders is included in the FieldPulse subscription and has to be enabled before you can create custom fields for its line items.
A line item custom field stores information about an individual item on a purchase order that the standard purchase order fields do not capture — whether the item has arrived, when it is due, or what condition it arrived in. You create each field once in Company Settings, and it then appears on the line items of every purchase order for the roles you gave access to.
## Overview
A line item custom field is an extra data point attached to the individual items on a purchase order rather than to the order as a whole. There is no limit on the number of line item custom fields you can create, and each field carries two controls you set when you build it — which roles can see the field, and whether the field also appears on the documents your customers and suppliers receive.
Line item custom fields are internal only and do not sync to QuickBooks.
Line item custom fields are separate from a purchase order's **Additional Fields**, which apply to the order as a whole and are created at **Company Settings > Orders > Custom Fields**. This page covers the fields on individual line items, created at **Company Settings > Orders > Line Item Custom Fields**. For the order-level fields, see [How to Manage Purchase Orders](/inventory-materials/purchase-orders/managing).
Common ways teams use line item custom fields:
* **Item status** — track each item in the order as "Not Arrived," "Dispatched," "Arrived," or "Returned."
* **Expected arrival date** — tell the team when items are due, which helps when items on one order arrive on different dates.
* **Item condition** — record the condition of an item on receipt and note any damage, so issues get addressed promptly.
* **Related job** — an entire purchase order can be related to a job, and a line item custom field ties a specific item to a particular job or project.
* **Return toggle** — mark items that need to go back and start the reorder.
## Video walkthrough
Watch the full walkthrough of line item custom fields, then follow the written steps below.
## Before you begin
* **Enable Purchase Orders.** Go to **Company Settings**, select **Features & Plugins**, find **Purchase Orders**, and select **Enable**. Line item custom fields live under the Orders settings that this turns on.
* **Decide who should see each field.** Every line item custom field carries role-based visibility, so know which roles need the field before you create it.
* **Decide whether customers and suppliers should see the field.** One toggle per field controls that, and it is off by default.
* **Plan the options for any drop-down field**, including which option should be the default. You add the options while you create the field.
## Step-by-step setup
### Create a line item custom field
1. Select **Company Settings** from the left side menu.
2. Scroll the top menu bar to the **Orders** tab and select it.
3. Select the **Line Item Custom Fields** tab.
4. Select **Create New**.
5. In the **Add Custom Field** window, enter the **Field Name**. This is the only required entry.
6. Select a **Type**. The settings reference below lists what each type stores.
7. For a **Drop-down** field, select **+ Add New Option**.
8. Enter the option name and select the save icon to keep it. Repeat for every option you need.
9. Mark one option as the **Default**. The option labeled **(Default)** is the value applied to every item until a user with permission changes it.
10. Set **Field Visibility by Role** by checking or unchecking each role — service agents, team managers, and administration.
11. Set **Is visible to customer & supplier**. On makes the field visible to customers and suppliers on purchase order PDFs, job reports, [estimates and invoices](https://www.fieldpulse.com/features/estimates-and-invoices), and asset reports; off keeps the field internal.
12. Select **Save**.
Each saved field appears on the **Line Item Custom Fields** page with an **Active** status.
## Filling in custom fields on a purchase order
Your line item custom fields appear on every purchase order under the **Purchase Order Items** heading, next to the item they belong to.
1. Select **Purchase Orders** from the left side menu.
2. Open an existing purchase order or create a new one.
3. Fill in each custom field on the line item it belongs to. A drop-down field opens the list of options you defined, and a checkbox field shows as a toggle.
## Reporting on line item custom fields
Line item custom fields come through as columns on the **Item Usage** report, so you can read them across every purchase order in a date range.
1. Select **Reporting** from the left side menu.
2. Scroll the top menu bar to the **Orders** tab and select **Item Usage**.
3. Choose your **Date Range** and select **Load Data**.
4. Select **Columns**, then check the box for each line item custom field you want in the report. Uncheck any column you do not need.
5. Select **Apply**.
Your line item custom fields appear as columns in the report alongside the standard item columns.
## Settings reference
### Field types
| **Field type** | **What it stores** |
| -------------- | ------------------------------------------------------------------ |
| **Free Text** | Text you type in your own words, with no restriction on the entry |
| **Number** | A number or quantity for the line item |
| **Date** | A date, filled in from a calendar icon |
| **Checkbox** | An on/off toggle |
| **Drop-down** | One selection from options you define, with a customizable default |
### Visibility controls
| **Control** | **What it does** |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Field Visibility by Role** | Sets which team members — service agents, team managers, and/or administration — can access the field, through a check mark next to each role. |
| **Is visible to customer & supplier** | When on, customers and suppliers see the field on purchase order PDFs, job reports, estimates, invoices, and asset reports. When off, the field stays internal. |
## Related articles
* [How to Manage Purchase Orders](/inventory-materials/purchase-orders/managing)
* [Setting Up Custom Fields on Material Lists](/inventory-materials/material-lists/custom-fields)
* [Setting Up Item List & Inventory](/inventory-materials/item-list/adding-items)
* [Material Lists Overview](/inventory-materials/material-lists/material-lists)
* [How to Create Item Usage Reports](/reporting/raw-data/item-usage-reports)
Your setup is working when you open a purchase order, find your custom fields under **Purchase Order Items** for the roles you chose, fill them in on each line item, and pull those same fields into an Item Usage report as columns.
## Related topics
- [How to Manage Purchase Orders](/inventory-materials/purchase-orders/managing.md)
- [Purchase Orders](/inventory-materials/purchase-orders/index.md)
- [Setting Up Item Custom Fields](/inventory-materials/item-list/item-custom-fields.md)
- [Setting Up Custom Fields on Material Lists](/inventory-materials/material-lists/custom-fields.md)