Proposals & Line Items
Line items are the foundation of your proposal. They detail the specific services, materials, and costs that make up your quote. This guide walks you through building professional, accurate proposals.
Quick Start: Build a Proposal in 5 Steps
- Open or create a project
- Go to the Proposal tab
- Click Add Line Item
- Enter item details and pricing
- Repeat for all items, then Save
Understanding Line Items
What Each Line Item Contains
| Field | Description | Example |
|---|---|---|
| Item Name | Service or material description | Drilling per foot |
| Quantity | Number of units | 150 |
| Unit | Measurement type | Feet |
| Unit Cost | Your internal cost per unit | $45.00 |
| Retail | The price the customer sees | $60.00 |
| Taxable | Whether tax applies to this line | Yes |
| Total | Auto-calculated | $9,000.00 |
| Description | Optional details, on its own row | 6" diameter borehole |
Unit Cost and Retail are different numbers, and Retail is the one that bills. When a line has a retail price, the total uses it. The total falls back to unit cost only when retail is blank or zero. Leaving retail at an old value is the usual reason a proposal total does not match what you expected.
Step-by-Step: Adding Line Items
Method 1: Manual Entry
- Open the project
- Go to the Proposal tab
- Click Add Line Item
- Enter item name
- Set quantity and unit cost
- Add description (optional)
- Click Add to confirm
- Repeat for each item
The button reads Add Line Item in the sections view, which is the view the Proposal tab opens in. In the flat list view the same button reads Add Custom Row.
Method 2: Pull an item from inventory
The Item Name box on each row searches your inventory as you type.
- Add a row.
- Start typing in the Item Name box. It reads Search inventory or type item name.
- Pick an item from the list that drops down.
- The unit cost, unit, taxable setting, and description fill in from that item.
- Set the quantity.
You bind one item per row this way. To enter something that is not in inventory, type the name and keep going.
Method 3: Using Templates
- Open the Select Template... dropdown.
- Choose a template.
- Review the line items it brings in, then adjust them.
- Click Save.
The dropdown appears only after your company saves at least one template. If you have never made one, the Proposal tab shows no template dropdown at all.
Create templates for common job types to speed up proposal creation. Templates can include standard line items with default pricing. To build one, go to Settings > Proposal Templates.
Applying a template no longer wipes an estimate you have already written. Before 18 August 2026, picking a template replaced the whole estimate, and a template that had no priced items could blank the proposal outright. DrillerDB now checks the proposal for existing content first. Written scope counts as content, so section titles, descriptions, and an add-on's pros and cons all protect the estimate, not just priced rows.
Managing Line Items
Editing Items
- Click on any line item field
- Edit the value inline
- Total recalculates automatically
- Click Save when done
Reordering Items
- Click and hold anywhere on the row, next to the grip mark (⋮⋮).
- Drag the row to its new position.
- Release to drop it.
- The customer proposal follows the same order.
The flat list view also gives each row a Move up and a Move down arrow. Use those when a drag is awkward, such as on a touch screen.
Deleting Items
Click the trash icon at the end of the row. The row goes straight away, with no confirmation step, so check that you have the right row before you click. The line is not gone for good until you click Save. To get it back before then, leave the page without saving.
There is no per-item Duplicate action. To repeat a line, add a row and pick the same inventory item.
Line Item Categories
Organize items by category for clear proposals:
| Category | Common Items |
|---|---|
| Drilling | Per-foot drilling, casing advancement |
| Casing | PVC casing, steel casing, drive shoe |
| Materials | Grout, bentonite, filter pack, sand |
| Permits | State permit fee, county fee |
| Pump Equipment | Submersible pump, pressure tank, pitless adapter |
| Labor | Pump installation, well development, testing |
| Mobilization | Setup fee, travel, equipment transport |
| Testing | Water quality test, bacteria test, yield test |
Setting Up Default Items
Creating Saved Line Items
- Go to Settings > Projects & Proposals
- Find Default Line Items
- Click Add Item
- Enter:
- Item name
- Default price
- Category
- Description
- Save
Updating Default Pricing
- Go to Settings > Projects & Proposals
- Find Default Line Items
- Click item to edit
- Update pricing
- Save
Updating default pricing only affects new proposals. Existing proposals keep their original pricing.
Creating Templates
Step-by-Step: Create a Template
- Go to Settings > Projects & Proposals
- Find Proposal Templates
- Click New Template
- Name your template (e.g., "Residential 6-inch Well")
- Add line items typical for this job type
- Set default quantities and pricing
- Save template
Template Best Practices
Good templates include:
- All common line items for that job type
- Realistic default quantities
- Current pricing
- Clear item descriptions
Template naming conventions:
- Residential - Standard
- Commercial - Small
- Hi-Cap - Agricultural
- Geo-Vertical - 4 Ton
Calculating Totals
Automatic Calculations
DrillerDB automatically calculates:
| Calculation | How It Works |
|---|---|
| Line Total | Quantity × Retail. When Retail is blank or zero, Quantity × Unit Cost |
| Subtotal | Sum of all line totals |
| Tax | Subtotal × Tax Rate, on taxable lines only |
| Grand Total | Subtotal + Tax |
| Deposit | Percentage or fixed amount |
Configuring Tax
- Go to Settings > Billing & Invoicing
- Set your default tax rate
- Enable or disable tax per project
- Tax applies to subtotal automatically
Setting Deposit Requirements
- Go to Settings > Billing & Invoicing
- Configure deposit options:
- Percentage (e.g., 50%)
- Fixed amount (e.g., $1,000)
- None required
- Choose if payment is required for approval
Item Descriptions
Adding Detailed Descriptions
- Click line item to expand
- Find Description field
- Enter detailed information
- Description appears below item name in proposal
What to Include
Good descriptions include:
- Materials specifications
- Work methodology
- Warranty information
- Exclusions or conditions
Example:
"6" diameter Schedule 40 PVC casing, includes threaded couplings, installed per manufacturer specifications. 10-year manufacturer warranty on materials."
Reviewing Before Sending
Proposal Checklist
Before sending, verify:
- All line items are complete
- Quantities are accurate
- Pricing is current
- Descriptions are clear
- Tax is correct
- Deposit amount is set
- Customer email is correct
Preview Feature
- Click Preview Proposal
- See exactly what customer sees
- Check formatting and totals
- Close preview when satisfied
Troubleshooting
Line items not saving?
- Check for validation errors
- Ensure quantity and price are numbers
- Verify required fields are complete
Template not loading?
- Check template exists in Settings
- Verify you have permission to use templates
- Template may be deactivated
Totals calculating incorrectly?
- Check quantity and unit cost values
- Verify tax rate in Settings
- Look for hidden line items
Can't add more items?
- Check your subscription limits
- Verify proposal isn't locked
- Try refreshing the page
Related Topics
- Creating Projects - Start new projects
- Sending Proposals - Send to customers
- Project Settings - Configure defaults
- Billing Settings - Tax and deposits