> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveinspect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Field Modifiers: Price Inspections by Units, Property Type or Any Question

> Charge more or less based on any answer you collect, such as the number of units, bedrooms, property type or county. Create a custom field in Hive Inspect first, then add a price modifier on it.

<p className="hive-locator">In the dashboard: <strong>Business Tools → Custom Fields</strong>, then <strong>Business Tools → Services & Fees → Edit a service → Add Modifier</strong></p>

## What custom field modifiers do

Hive can price on its own by square footage, age, distance, foundation, day and time. See [Price modifiers](/how-tos/price-modifiers). For anything else, you make your own: ask a question with a **custom field**, then add a **modifier** that charges based on the answer.

For example:

* **Number of Units:** \$150 for each unit after the first, so a duplex costs \$150 more and a fourplex \$450 more.
* **Property Type:** \$50 off for condos, \$100 more for mobile homes.
* **Number of Bedrooms:** \$50 more for 5 or more bedrooms.
* **County:** a \$25 travel fee for one county.

It takes two steps, always in this order:

1. **Create the custom field** in **Business Tools → Custom Fields**.
2. **Add a modifier on that field** to a service in **Business Tools → Services & Fees**.

A modifier can only use a custom field that already exists. Until you create one, the **Custom Fields** group doesn't appear in the modifier's **When** list.

## Which field types can set a price

| Field type | Modifier types | Best for |
| - | - | - |
| **Number** | **Per Unit**, **Per Unit Over**, **Range** | Counts and sizes: units, bedrooms, bathrooms, acres, outbuildings |
| **Dropdown** | **Equals To** | A fixed list of choices: property type, county, Yes or No questions |
| **Text** | **Equals To** | Free-typed answers. Use a Dropdown instead where you can, because a typing mistake means no match |
| **Checkbox** | None | Checkboxes can't set a price. For a yes-or-no charge, use a Dropdown with the options **Yes** and **No** |

## Step 1: Create the custom field

<Steps titleSize="h3">
  <Step title="Open Custom Fields">
    Click **Business Tools** in the sidebar, then **Custom Fields**, then **Add Custom Field**.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-fields-page.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=056f3b771ba89e10451ff152c0f7a7a0" alt="The Custom Fields page with an Add Custom Field button and four field cards: Number of Units (Number), Property Type (Dropdown), County (Text) and Detached Garage (Checkbox). Each card shows its placeholder, such as {{{custom_number_of_units}}}, badges for Required on Scheduler, Show on Scheduler and Mobile App, and Edit and delete buttons" width="1800" height="1151" data-path="images/how-tos/custom-field-modifiers-fields-page.png" />
  </Step>

  <Step title="Name the field">
    Type the question as your team and clients should see it, such as **Number of Units**. Names can be up to 50 characters.

    Hive makes a **placeholder** from the name, such as `{{{custom_number_of_units}}}`. The modifier is tied to that placeholder. The placeholder stays the same if you rename the field later, so its modifiers keep working. See [Renaming or deleting a field](#renaming-or-deleting-a-field).
  </Step>

  <Step title="Pick the Field Type">
    Pick **Number** for counts, or **Dropdown** for a list of choices. **Text** also works. **Checkbox** can't set a price.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-type-list.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=c15443a27b7a3fccc46717392323b4d3" width="460" alt="The Create Custom Field dialog with the Field Type list open, showing Text, Number (checked), Checkbox and Dropdown" data-path="images/how-tos/custom-field-modifiers-type-list.png" />

    For a **Dropdown**, type each option and press **Enter**. Add every option you want to price before you add the modifier.
  </Step>

  <Step title="Choose where the field appears">
    Turn on the settings you need:

    | Setting | What it does |
    | - | - |
    | **Show on online scheduler** | Clients answer the question when they book on your online scheduler or use your quote widget. **Turn this on if clients book online**, or the modifier can't apply to their bookings. |
    | **Required answer on online scheduler** | Clients can't continue until they answer. It only works when **Show on online scheduler** is also on. It doesn't apply when your team schedules in the dashboard. |
    | **Display on mobile app** | Inspectors see and can fill in the field on the inspection in the mobile app. |

    Your team always sees every custom field when scheduling in the dashboard, whatever these settings are.
  </Step>

  <Step title="Click Create Custom Field">
    <Tabs>
      <Tab title="Number field">
        <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-create-number.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=81a30078e8515514feb3243c44eb1333" width="460" alt="The Create Custom Field dialog: Name Number of Units, Placeholder {{{custom_number_of_units}}}, Field Type Number, and the settings Required answer on online scheduler, Show on online scheduler and Display on mobile app all turned on. Buttons Cancel and Create Custom Field" data-path="images/how-tos/custom-field-modifiers-create-number.png" />
      </Tab>

      <Tab title="Dropdown field">
        <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-create-dropdown.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=2c193414465a70ecdbc36c761e5d62fe" width="460" alt="The Create Custom Field dialog: Name Foundation Style, Field Type Dropdown, Options Slab, Crawlspace, Basement and Pier and Beam with a box that reads Type an option and press Enter, Show on online scheduler and Display on mobile app turned on" data-path="images/how-tos/custom-field-modifiers-create-dropdown.png" />
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Step 2: Add a modifier on the field

<Steps titleSize="h3">
  <Step title="Open the service">
    Go to **Business Tools → Services & Fees** and click the pencil icon on the service. Under **Service Modifiers**, click **Add Modifier**.

    To price an add-on instead, open the add-on and use **Add Modifier** under **Add-On Modifiers**.
  </Step>

  <Step title="Pick your field in the When list">
    Your fields are at the bottom of the list, under **Custom Fields**. Checkbox fields aren't listed.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-when-list.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=cb13d8b0c3e5e180e35fb41a1c29ea36" width="520" alt="The When list in the Add New Modifier dialog scrolled to the bottom, showing Foundation, the Time Based group (Specific Day, After Working Hours, Before Working Hours) and the Custom Fields group with Number of Units, Property Type and County" data-path="images/how-tos/custom-field-modifiers-when-list.png" />
  </Step>

  <Step title="Pick the Type and fill it in">
    A **Number** field offers **Range**, **Per Unit** and **Per Unit Over**. A **Dropdown** or **Text** field has only **Equals To**, which Hive picks for you. Each type is explained below.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-number-types.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=a130705bce5429d88fa06e53c83304b1" width="520" alt="The Add New Modifier dialog with When set to Number of Units and the Type list open, showing Range, Per Unit and Per Unit Over" data-path="images/how-tos/custom-field-modifiers-number-types.png" />
  </Step>

  <Step title="Click Add Modifier">
    On an existing service, the change saves on its own. On a new service, click **Save Service**. The modifier is named after the field, such as **Number of Units**.
  </Step>
</Steps>

## Number fields

### Per Unit Over

Charges for every unit **above** a starting number. This is the usual choice for multi-unit buildings, where the base price already covers the first unit.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-per-unit-over.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=56419cea4a354f856128cb8e24947833" width="460" alt="A Number of Units modifier with the type Per Unit Over: Starting After 1, Per-unit pricing will apply only after this base value, Add Fees 150 and Add Hours 1" data-path="images/how-tos/custom-field-modifiers-per-unit-over.png" />

The charge is **(the answer minus Starting After) × Add Fees**. **Add Hours** works the same way.

### Per Unit

Charges for **every** unit in the answer: **the answer × Add Fees**. There is no starting number.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-per-unit.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=48383b9d2538a5b32155802bc7806ec1" width="460" alt="A Number of Units modifier with the type Per Unit: Fee and hours will be added per unit of this custom field value. Add Fees 25 and Add Hours 0" data-path="images/how-tos/custom-field-modifiers-per-unit.png" />

### Per Unit and Per Unit Over compared

With **Add Fees** \$150, and **Starting After** 1 for Per Unit Over:

| Number of Units | Per Unit Over (Starting After 1) | Per Unit |
| - | - | - |
| 1 (single family) | \$0 | \$150 |
| 2 (duplex) | \$150 | \$300 |
| 3 (triplex) | \$300 | \$450 |
| 4 (fourplex) | \$450 | \$600 |

Answers aren't rounded. An answer of 2.5 with Per Unit at \$10 adds \$25. If the answer is 0 or empty, nothing is added.

### Range

A flat amount when the answer is in a band. Ranges on custom fields are typed as **More than** and **Up to**: the first number is **not** included, the second is.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-range.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=47f86e42c011d0385812be4ad66b7d4c" width="460" alt="A Number of Units range: More than 2, Up to 4. Range: Applies when the value is more than 2 and up to 4. Exactly 2 is not included, exactly 4 is. Add Fees 200 and Add Hours 1" data-path="images/how-tos/custom-field-modifiers-range.png" />

For whole-number answers such as units or bedrooms:

* **More than 2, Up to 4** covers 3 and 4.
* To charge for exactly 5, use **More than 4, Up to 5**.
* For 5 or more, use **More than 4** and a high **Up to**, such as 100.

Hive warns you about gaps and overlaps between ranges on the same field, just like the property ranges. See [How ranges work](/how-tos/price-modifiers#how-ranges-work).

## Dropdown and Text fields: Equals To

**Equals To** adds a flat amount when the answer matches the value you set.

<Tabs>
  <Tab title="Dropdown field">
    Pick the option from the **Expected Value** list. This example takes \$50 off for condos.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-dropdown-equals.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=0aa8a749249d38031dcae2d5a699a3d1" width="460" alt="A Property Type modifier with the type Equals To: Applies a flat fee and hours when Property Type equals the value below. Matches are case-insensitive and ignore surrounding whitespace. Expected Value Condo, Add Fees -50 and Add Hours 0" data-path="images/how-tos/custom-field-modifiers-dropdown-equals.png" />

    If the dropdown has no options yet, the form says "This dropdown has no options configured. Edit the custom field to add options, then come back."
  </Tab>

  <Tab title="Text field">
    Type the value in **Expected Value**.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-text-equals.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=3286d69e280851be3d200eb45e79863e" width="460" alt="A County modifier with the type Equals To: Expected Value Cook, The modifier fires when the submitted county matches this value, Add Fees 25 and Add Hours 0" data-path="images/how-tos/custom-field-modifiers-text-equals.png" />

    The answer must match the whole value. Capital letters and spaces at the start or end don't matter, so "cook" and " Cook " match **Cook**. But "Cook County" or a misspelling doesn't match.
  </Tab>
</Tabs>

Things to know about Equals To:

* **One value per modifier.** To price several choices, add one modifier for each, such as one for **Condo** and one for **Mobile Home**.
* **Negative amounts are discounts.** Type **-50** in **Add Fees** to take \$50 off.
* **Yes-or-no questions:** create a Dropdown with **Yes** and **No**, then add an Equals To modifier for **Yes**.

## Where the answers come from

A custom field modifier applies when the field has an answer on the inspection.

<Tabs>
  <Tab title="Dashboard">
    When you schedule in the dashboard, every custom field is in the **Custom Fields** card on the New Inspection page, whatever its settings. The **Pricing Summary** below it shows the modifier as soon as the service is picked.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-dashboard-fields.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=a1cf979f6815256128c008d0784eecd0" alt="The Custom Fields card on the New Inspection page: Number of Units 2, Property Type Condo, County (empty) and a Detached Garage checkbox, each with its placeholder below it" width="1800" height="394" data-path="images/how-tos/custom-field-modifiers-dashboard-fields.png" />

    Before the inspection is confirmed, changing an answer updates the **Pricing Summary**: a line that counts units is worked out again from the new number, and a modifier that no longer applies is removed. A line you changed with **Edit Price or Duration** keeps your price.
  </Tab>

  <Tab title="Online scheduler">
    Fields with **Show on online scheduler** turned on appear under **Additional Information** on the **Property Details** step. Required fields have a red star, and the others say "(Optional)". The quote widget asks the same questions.

    <img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-scheduler-questions.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=d9ee17629a1cf59466a64649b61e84d8" width="620" alt="The Additional Information section on the online scheduler: Number of Units with a red star and the answer 2, Property Type (Optional) with Condo picked, County (Optional) with Cook, and a Detached Garage checkbox" data-path="images/how-tos/custom-field-modifiers-scheduler-questions.png" />

    The prices clients see already include their answers. When the inspection is booked, Hive works out the price again from the answers.
  </Tab>

  <Tab title="Mobile app">
    Fields with **Display on mobile app** turned on are in the **Custom Fields** card on the inspection. Inspectors can fill them in or change them there.

    Answers entered in the mobile app don't change the price of an inspection that is already booked. If an answer changes the price, update the line in the dashboard with **Edit Price or Duration**.
  </Tab>
</Tabs>

<Note>
  Once an inspection is confirmed, changing an answer never changes its price, in the dashboard or the mobile app. To change the price, use **Edit Price or Duration** in the dashboard.
</Note>

## Test the modifier

Go to **Business Tools → Services & Fees** and click **Test Pricing with Modifiers**. Your custom fields are under **Additional Information**. Type an answer, click **See service prices**, and open the modifier list to see what each modifier added and why.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/price-modifiers-test-pricing-breakdown.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=24ef648eb67cf7cdd05f00098e4370d2" alt="Test Pricing results for Home Inspection, $893: among the modifier lines, Number of Units: 2 (1 billable after 1) x $150/unit adds $150 and 1 hr, and Property Type: Condo matches Condo takes off $50" width="1800" height="1519" data-path="images/how-tos/price-modifiers-test-pricing-breakdown.png" />

If a modifier uses a custom field that isn't shown on your online scheduler, Test Pricing warns you: "Some modifiers reference custom fields that aren't shown on the online scheduler — they can never apply in the live quote". The modifier still works when your team fills in the field in the dashboard.

## Renaming or deleting a field

A modifier is tied to the field's placeholder, such as `{{{custom_number_of_units}}}`.

### Renaming a field

Renaming keeps the placeholder, so nothing stops working: the field's modifiers, the answers already saved on inspections, and the placeholder in your emails, agreements and templates. Modifiers named after the field take the new name in your modifier list.

Two fields can't have the same name.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-rename.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=fa5c2c3d96bcc73ece3abfc8400f346c" width="460" alt="The Edit Custom Field dialog with the name changed from Number of Units to Units. The Placeholder row still shows {{{custom_number_of_units}}}, and the description says the placeholder stays the same when you rename the field, so templates, automations and price modifiers keep working" data-path="images/how-tos/custom-field-modifiers-rename.png" />

### Deleting a field

The delete dialog lists every service and add-on with a modifier that uses the field. After you delete it, those modifiers never apply again.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-delete.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=485e3ed8371401228ef5ab45228edde0" width="420" alt="The Delete Custom Field dialog for Number of Units. A red box says Used for pricing: 2 price modifiers use this field and will stop applying, listing Home Inspection and Home Inspection, Radon Testing, and suggests editing the field instead to change only the name. A yellow warning says the placeholder will no longer be replaced in templates and automations" data-path="images/how-tos/custom-field-modifiers-delete.png" />

On the service page, each of those modifiers then says that its custom field was deleted. Edit it to pick another field in the **When** list, or delete it.

<img src="https://mintcdn.com/hiveinspect-43c85ed1/f7fh1ZjyPiNnRrw9/images/how-tos/custom-field-modifiers-deleted-field.png?fit=max&auto=format&n=f7fh1ZjyPiNnRrw9&q=85&s=e4e2e1bdbb202003bdd7060d08d780e0" alt="A Zip Code modifier card, Equals To 78701, +$25 / +0hrs, with the note: Its custom field was deleted, so this modifier never applies. Edit it to choose another field, or delete it" width="1464" height="272" data-path="images/how-tos/custom-field-modifiers-deleted-field.png" />

See [Add custom fields](/how-tos/custom-inspection-fields#use-custom-fields-as-placeholders) for how placeholders work in emails, agreements and templates.

## Ready-made examples

<AccordionGroup>
  <Accordion title="Number of units: a fee for each unit after the first" id="example-number-of-units">
    1. Custom field: **Number of Units**, **Number**, with **Show on online scheduler** and **Required answer on online scheduler** turned on.
    2. Modifier: **When** Number of Units, **Type** Per Unit Over, **Starting After** 1, **Add Fees** 150, **Add Hours** 1.

    A duplex adds \$150 and 1 hour. A fourplex adds \$450 and 3 hours.
  </Accordion>

  <Accordion title="Bedrooms: a fee for 5 or more" id="example-bedrooms">
    1. Custom field: **Number of Bedrooms**, **Number**.
    2. Modifier: **When** Number of Bedrooms, **Type** Range, **More than** 4, **Up to** 100, **Add Fees** 50.
  </Accordion>

  <Accordion title="Property type: a condo discount and a mobile home fee" id="example-property-type">
    1. Custom field: **Property Type**, **Dropdown**, with the options Single Family, Condo, Townhouse and Mobile Home.
    2. Modifier: **When** Property Type, **Expected Value** Condo, **Add Fees** -50.
    3. A second modifier: **When** Property Type, **Expected Value** Mobile Home, **Add Fees** 100.
  </Accordion>

  <Accordion title="A pool or a detached garage: a flat fee when the answer is Yes" id="example-yes-no">
    1. Custom field: **Pool**, **Dropdown**, with the options Yes and No. Don't use a Checkbox, because checkboxes can't set a price.
    2. Modifier: **When** Pool, **Expected Value** Yes, **Add Fees** 75, **Add Hours** 0.5.
  </Accordion>

  <Accordion title="A travel fee for some counties" id="example-county">
    1. Custom field: **County**, **Dropdown**, with every county you serve as an option.
    2. One Equals To modifier for each county that costs extra, such as **Expected Value** Cook, **Add Fees** 25.

    To charge by actual driving distance instead, use a [distance modifier](/how-tos/price-modifiers#distance).
  </Accordion>
</AccordionGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why isn't my custom field in the When list?" id="custom-field-missing-from-when">
    Checkbox fields can't set a price, so they aren't listed. Also, the list is loaded when the service page opens. If you created the field after opening the service, reload the page.
  </Accordion>

  <Accordion title="My custom field modifier works in the dashboard but not on online bookings. Why?" id="custom-field-modifier-online">
    The field probably has **Show on online scheduler** turned off, so clients never answer it. Turn it on in **Business Tools → Custom Fields → Edit**. If clients must answer, also turn on **Required answer on online scheduler**.
  </Accordion>

  <Accordion title="What's the difference between Per Unit and Per Unit Over?" id="per-unit-vs-per-unit-over">
    **Per Unit** charges for every unit in the answer. **Per Unit Over** charges only for the units above **Starting After**. Use Per Unit Over when the base price already covers the first unit, or the first few.
  </Accordion>

  <Accordion title="Can one field have several modifiers?" id="several-modifiers-one-field">
    Yes. You can add several ranges on one number field, or one Equals To modifier for each dropdown option. Every modifier whose condition is met is added.
  </Accordion>

  <Accordion title="Can I use a custom field modifier on an add-on?" id="custom-field-modifier-add-on">
    Yes. Open the add-on under **Service Add-Ons** and use **Add Modifier** in **Add-On Modifiers**. It applies only when the add-on is on the inspection.
  </Accordion>

  <Accordion title="Do clients see the custom field charge as its own line?" id="custom-field-charge-visible">
    No. Clients see one price for the service, with the charge included. Your team sees it as its own line, named after the field, in the dashboard's **Pricing Summary**.
  </Accordion>
</AccordionGroup>

<p className="hive-label">Related</p>

<div className="hive-rows hive-rows-sm">
  <a className="hive-row" href="/how-tos/price-modifiers">
    <span className="hive-row-main">
      <span className="hive-row-title">Price modifiers</span>
      <span className="hive-row-line">Square footage, age, distance, foundation, day and time charges</span>
    </span>
  </a>

  <a className="hive-row" href="/how-tos/custom-inspection-fields">
    <span className="hive-row-main">
      <span className="hive-row-title">Add custom fields</span>
      <span className="hive-row-line">Collect extra information and use it in emails, agreements and templates</span>
    </span>
  </a>

  <a className="hive-row" href="/business-tools/services-and-fees">
    <span className="hive-row-main">
      <span className="hive-row-title">Set up services and fees</span>
      <span className="hive-row-line">Create services, link templates and agreements, add add-ons and taxes</span>
    </span>
  </a>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.