The new DrillerDB is out of beta.See what's new

Well Log (Well Completion Report)

How to fill out, import, and manage Well Completion Reports in DrillerDB projects

Well Log (Well Completion Report)

The Well Log tab is where you record your Well Completion Report (WCR) -- the official record of how a well was constructed. DrillerDB breaks the WCR into clear sections that match state reporting requirements. You can fill it out by hand, import data from a PDF, or generate a state-specific form for download.

The Well Log tab of a project, showing the Well Completion Report header with the help, Import from PDF, Generate As-Built, Cancel, and Save buttons, the Well Construction Details section (Drill Method, Screen Slot Size, Pump Type, Total Depth, Well Diameter, Pump Depth, Yield, Disinfection Type and Amount), and the start of the Drillhole Dimensions and Construction Method section below it.

Quick Start

  1. Open a project from Projects
  2. Select the Well Log tab
  3. Set the Well result, then fill out construction, casing, grout, geology, water level, pumping test, and well status details
  4. Use Import from PDF if you have an existing report to extract
  5. Use Generate As-Built or the state well-log download button when the report is ready

Step-by-Step: Complete a Well Log

Work through the Well Log tab from top to bottom, then review imported or generated output before using it for compliance or billing.

Opening the Well Log

  1. Open any project from the Projects list
  2. Click the Well Log tab in the tab bar

At the top, the Well result list records how the well turned out: Producing, Dry hole, Abandoned, or Not set. It saves with the well log.

The Well Log tab appears on every project. You do not need to enable it separately.

Sections of the Well Log

The well log form is divided into these sections. Scroll down through the form to fill out each one.

Drillhole Dimensions & Construction Method

Records the borehole diameter and depth intervals, plus the drilling method used.

The Drillhole Dimensions & Construction Method section of the Well Log tab, with an + Add Interval button, diameter/from/to interval columns, and the construction-method checklist (Rotary - Mud Circulation, Rotary - Air, Rotary - Air & Foam, and more) split into Upper Enlarged and Lower Open Bedrock columns.
  1. Enter the Dia. (in.), From (ft.), and To (ft.) for each drill hole section
  2. Click + Add Interval if the hole changes diameter at different depths
  3. Check the boxes for the construction methods used -- mark whether each method was used for the Upper Enlarged Drillhole (left column) or Lower Open Bedrock (right column)

Available methods include:

  • Rotary - Mud Circulation
  • Rotary - Air
  • Rotary - Air & Foam
  • Drill-Through Casing Hammer
  • Reverse Rotary
  • Cable-tool Bit (enter bit size in inches)
  • Dual Rotary
  • Temp. Outer Casing (enter diameter)

Well Construction Details

This section opens the form. It holds the summary fields for the well:

  • Drill Method, Screen Slot Size, and Pump Type (pick from the lists)
  • Total Depth (ft), Well Diameter (in), and Pump Depth (ft)
  • Yield (GPM)
  • Disinfection Type and Disinfection Amount (for example, "1 gallon" or "500 ppm")

Colorado wells add fields here, such as Permit Number and Aquifer Name. New Mexico wells also get a New Mexico OSE well record section and a plugging record.

Colorado wells use the state's own section names: Borehole and Drilling Method, Casing, Geologic Log, Annular Materials, and Well Yield Estimate, plus Disinfection and Well Development and Cleaning sections. The columns follow the Colorado form, with Interval Top and Interval Bottom in place of From and To.

Casing, Liner & Screen

Records the casing, liner, and screen specifications installed in the well.

  1. For each casing/liner/screen section, enter:
    • Dia. (in.) -- the pipe or screen diameter
    • Material, Weight, Spec, Mfr, Assembly -- type of casing (e.g., "Std Blk Pipe 18.97 New Steel Plain End Welded Joint")
    • From (ft.) -- starting depth
    • To (ft.) -- ending depth
  2. Click + Add Casing to add additional casing sections

Most wells have at least one casing entry. Multi-stage wells may have several rows with different diameters and materials at different depths.

Grout / Sealing Material

Records the grout and sealing materials used to seal the annular space between the casing and the borehole.

  1. Enter the Method used for grouting (e.g., tremie pipe, pressure) and the Grout Type
  2. For each sealing layer, enter:
    • Kind of Sealing Material -- e.g., "Drill Cuttings", "Neat Cement"
    • From (ft.) and To (ft.) -- the depth interval
    • # Sacks Cement -- number of sacks used (if applicable)
  3. Click + Add Grout for additional sealing layers. In Colorado the section is called Annular Materials and the button reads + Add Annular Interval.

Geology / Formation Log

Records the geological formations encountered during drilling, from surface to total depth.

The Geology / Formation Log section of the Well Log tab, with an + Add Formation button, columns for Code, Type/Caving/Color/Hardness, From (ft.), To (ft.), Water Bearing, and Comments, plus a free-text Geology / Formation Notes box. The collapsed Casing, Grout / Sealing Material, Pumping Test, Well Status, and Comments sections are visible around it.
  1. For each formation layer, enter:
    • Code -- the formation code number
    • Type, Caving, Color, Hardness -- a description of the formation (e.g., "Clay, brown, soft")
    • From (ft.) and To (ft.) -- depth interval
    • Water Bearing and Comments -- optional
  2. Click + Add Formation for each new formation layer
  3. Use the notes box under the table for anything the columns do not cover

Enter geology layers from shallowest to deepest. The "From" depth of each layer should match the "To" depth of the layer above it.

Static Water Level

Records the depth at which water naturally rests in the well when no pumping is occurring.

  1. Enter the Static Water Level (ft)
  2. Under Ground Surface, select Above or Below

Pumping Test

Records the results of the well's pumping test, which determines the well's yield.

  1. Enter the Pumping Level (ft below surface) -- how far down the water stood while pumping
  2. Enter the Pumping Rate (GPM)
  3. Enter the Duration (hrs)
  4. Select the pumping method: Airlift, Test Pump, or Other

Colorado wells see this section as Well Yield Estimate, with extra fields such as the mean pumping rate and Final Drawdown (ft).

Well Status

Records the final condition of the well after construction.

  1. Enter the Well Height (inches)
  2. Under Casing Extends, select Above Grade or Below Grade
  3. Answer Yes or No for each item:
    • Developed -- Was the well developed (cleaned out)?
    • Disinfected -- Was the well disinfected?
    • Capped / Sealed -- Is the well properly capped?
  4. Enter any Field Comments or Office Comments in the Comments section at the bottom of the form

Importing from PDF

Instead of typing everything manually, you can import well log data from a PDF file.

  1. Click the Import from PDF button at the top of the Well Log tab
  2. Upload your PDF file (a scanned WCR, state form, or driller's report)
  3. DrillerDB uses AI to extract the data. When it finishes, a box reads Apply imported well log? Existing values for the same fields are replaced, so check first
  4. Click Apply to form, then review the data and make any corrections
  5. Click Save. The import does not save by itself

Import takes PDF files only. It works best with clearly formatted documents. Handwritten forms may require more manual corrections after import.

Generate As-Built Diagram

Click the Generate As-Built button to create a visual diagram of the well construction based on the data you have entered. This shows the casing, screen, grout, and geology layers in a cross-section view.

When a seal has no depths

A grout row needs a From (ft.) and a To (ft.) before the diagram can draw a band for it. A row that records the material and the sacks but leaves the depths blank is common on older paper logs, and it used to draw nothing at all, so a sealed well could read as unsealed to whoever reviewed the drawing.

The diagram now says so. Under the summary line at the top it prints one line for each such row:

Seal: Bentonite, 8 sacks - sealing interval not recorded

The sack count appears only when the row records one, and a single sack reads "1 sack". Fill the depths in and the note is replaced by a drawn band, labelled the same way:

Bentonite 18-42 ft, 8 sacks

Material names are capitalised for the drawing, so "bentonite" typed in the table appears as "Bentonite". Capitals you typed are left as they are, which keeps "BENTONITE CHIPS" and "GRAVEL PACK" intact.

Downloading State Well Log Forms

For projects in supported states, a Download [State] Well Log button appears in the header (for example, Download CO Well Log). Click it to download a pre-filled state-specific well log form as a PDF. Check every field before you file it.

Supported states include: Alaska, Colorado, Florida, Georgia, Hawaii, Iowa, Idaho, Illinois, Kansas, Mississippi, New Hampshire, New Mexico, Nevada, New York, Oregon, South Carolina, South Dakota, Tennessee, Utah, Washington, and Wyoming.

The Illinois and Wyoming forms are part of Compliance Forms. On a plan without it, the Well Log tab shows a note with a See plans link instead of the download button. States with a plugging record form, such as New Mexico, also get a Download [State] Plugging Record button.

If your state has no form yet, the button reads Download Construction Log (no [State] state form yet). It still downloads the one-page construction log.

Alaska companies default to the Water Well Construction Log, not the state form. The button in the header is Download Construction Log, and it downloads the one-page construction log described below instead of the Alaska state well log form. A second button, Download AK State Form, is still there for the state form. You can change which one is the default -- see the next section.

Choosing Your Default Well Log PDF

DrillerDB can produce two different PDFs from the same well log: the state well log form (a pre-filled version of your state's official form, where available) and the Water Well Construction Log (a one-page log with a company block, owner and job header, and a Drillers Material Log table of depth intervals). Both are always available as separate buttons on the Well Log tab. What differs is which one the plain Download Construction Log / Download [State] Well Log button produces when you click it without picking a specific layout.

  • Every company defaults to the state well log form, except Alaska companies, which default to the Water Well Construction Log.
  • To set your own default, go to Settings > Branding and find the Well Log PDF card. Choose a layout from the Default well log layout dropdown. If you have not chosen one, the card tells you which default you are currently getting.
  • Your choice applies to every project. The other layout stays one click away on the Well Log tab either way.

Filing Online With Your State DNR

For wells in Colorado, Kansas, Oklahoma, South Carolina, Texas, and Wisconsin, a blue box at the top of the tab asks Filling this well log out online with the [State] DNR? Fill out and save the well log first. Then click Open Compliance tab for the required state forms and the DrillerDB Chrome extension, which fills in the state's online well report from your saved well log.

To look at wells near the project, use Nearby wells on the Overview tab's site map. See Project Map.

Saving Your Well Log

The well log does not save as you type. Click Save at the top of the Well Log tab when you are done. Cancel asks Discard unsaved changes? first, then puts back the well log as it was last saved. While you have unsaved edits, the header shows Unsaved changes.

Until you save, DrillerDB keeps your entries in this browser. If you reload the page or leave the tab before you save, a note says the entries were not saved. Click Restore entries to put them back in the form, or Discard entries to remove them from this browser.

Changing the project status or editing the Overview tab on the same page does not stop a well log Save.

Saving also fills any blank spec on the project's Overview tab from the well log. When you change the well log later, Well Depth, GPM and Static Water Level follow the new values if the well log filled them. A value someone typed on the Overview tab, 0 included, is never replaced, and Casing and Suggested Pump are filled only while they are blank.

Overview fieldFilled from
Well DepthThe total depth, or else the depth completed, or else the deepest interval you logged in Geology, Drillhole Dimensions or Casing, Liner, Screen
CasingThe casing depth, or else the bottom of the deepest casing row in Casing, Liner, Screen (screen and perforated rows are left out)
GPMThe yield, or else the pumping test rate
Static Water LevelThe static water level
Suggested PumpThe pumping level

Static Water Level and Suggested Pump show on the Overview tab only when your company has turned those fields on.

If someone else saved the well log first

If another person saved a different well log on this project after you opened it, Save stops with "Someone saved a different version of this well log after you opened it. Your entries are still in the form." Pick one:

ButtonWhat happens
Save my versionYour entries replace the saved well log
Show the saved versionThe form shows the other person's well log. Your entries stay in this browser, and Restore entries brings them back
Not nowThe message closes. Nothing is saved yet

If other project details changed instead, the message reads "This project was changed after you opened it. Your entries are still in the form." It offers Save my version and Not now.

Common Questions

Can I edit the well log after saving? Yes. The well log is always editable. Open the project and click the Well Log tab to make changes.

What if my state is not in the download list? You can still fill out the well log form in DrillerDB. The data is stored the same way regardless of state. The download button is just a convenience for states with fillable PDF forms.

Can I import data from Excel instead of PDF? Not in the console. The Import button on the Projects page (under More on a narrower window) reads PDF well reports and images, not spreadsheets. If your well records are in a spreadsheet, send the original CSV or XLSX file to support@drillerdb.com and we will import it for you. See Spreadsheets of past projects.

Does the geology data show up anywhere else? The geology formations you enter in the well log feed into the AI geology synthesis feature and appear on the well map for nearby well analysis.