Price Codes

Price codes are your organization's price list. When the AI estimator builds an estimate, it matches each scope item to a code and uses that code's price. Codes come from two places: the shared price-code library that every organization starts with, and the codes you add yourself, either brand new ones or overrides of shared entries.

This page covers the Add tab in Settings → Price Codes: adding a single code by hand, and bulk-importing many at once from a spreadsheet.

What's a category?

A category is the trade grouping a price code belongs to. There are about 30 of them. For example:

• WTR: Water Damage Mitigation (dehumidifiers, air movers, extraction)
• DRY: Drywall install & repair
• PNT: Paint
• CDC: Cleaning, Carpet & Soft Goods

Categories come from the shared library; you can't invent new ones. If you're not sure which one a code belongs to, the Reference tab in the import spreadsheet lists every category with a plain-English description.

What's an item code?

An item code (also called a selector) is a short identifier, usually 3–8 characters, that is unique inside a category. Examples within WTR:

• DHM: Dehumidifier (up to 69 ppd)
• AMS: Air mover
• EXT: Water extraction

Combined, the category plus the item code (WTR · DHM) is the lookup key the AI estimator uses to match a scope item to your pricing.

Overriding a shared code

To replace a shared library price with your own, add a code with the same category and item code. The AI substitutes your price automatically wherever that code is used. On the Manage tab, your overrides show with an amber stripe so you can tell them apart from untouched library entries.

Add one code manually

On the Add tab, click Add price code. Pick the category, then enter the item code, description, unit, and price. This is the quickest path for one-off codes or a quick price fix.

Bulk import from a spreadsheet

For a whole price list, use the import flow:

1. Download the template from the Add tab. The .xlsx file has two tabs: Price Codes, where you enter your data, and Reference, a lookup of every valid category and unit with its description.
2. Fill in one row per code. The Category and Unit cells are dropdowns, so you can't type an invalid value. Flip to the Reference tab if you don't know what a code means.
3. Save the file as .xlsx or .csv, and keep it under 5 MB.
4. Upload it and click Preview & verify.
5. Review the preview. Every row gets a status before anything is written:
   • Valid: the row will be imported, marked as either a new code or an update to an existing one.
   • Invalid: something's wrong with the row (a missing field, an unrecognized value). Invalid rows are skipped on import; everything else still goes through.
   • Superseded: the same category + item code appears again later in the file. The last occurrence wins; earlier duplicates are skipped.
6. Confirm the import. You'll see how many codes were added, how many were updated, and a list of any skipped rows with the reason for each.

Re-importing the same file is safe: rows that match an existing code update it in place rather than creating a duplicate.

After importing

Your codes appear on the Manage tab alongside the shared library. Codes that override a shared entry carry the amber stripe; fully custom codes don't. Either kind can be edited or removed there later.