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

# Data completeness

> Review meter timelines and upload missing bills to close data completeness gaps in EnerG

Fix meter coverage gaps in EnerG before they skew analytics or benchmarking. This page walks you through reviewing a meter timeline and uploading the bills that raise its <Tooltip tip="A score from 0% to 100% that measures billed coverage from each meter's service start through today.">data completeness</Tooltip> score.

To learn how EnerG scores coverage and why gaps and overlaps lower it, see the [data completeness concept](/products/energ/concepts/data-completeness).

## Where you see completeness

You view completeness in several places throughout EnerG.

* **KPI card on the Home page**: The **Data Completeness** card shows the portfolio-wide percentage on the [Portfolio Home](/products/energ/analytics/benchmarking) page.
* **Building detail panel**: Each building's detail panel on **Home** shows a completeness score and trend chart.
* **Data Quality report**: Open **Data Quality** from the [Building Energy dashboard](/products/energ/analytics/building-dashboards-energy#data-quality) report menu for meter-by-meter coverage at the building level.
* **Portfolio meters**: [Portfolio meters](/products/energ/analytics/portfolio-meters) lists monthly completeness percentages by account and meter.

<h2 id="review-gaps-on-a-meter">
  Review gaps on a meter
</h2>

Open [Building meters](/products/energ/buildings/meters), select a meter, then open the **Data Quality** tab. The **Bills Data Quality** chart shows how each day in the date range is classified.

<Frame caption="Bills Data Quality chart with a gap segment highlighted">
  <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-data-completeness-meter-gap-timeline.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=cadcc4fc870992ee8dd8277db4eed649" alt="Meter detail Data Quality tab for 8365020 03 with Bills Data Quality timeline showing mostly Complete green segments and a light blue Gap segment with tooltip for Electric meter December 04 2025 to December 05 2025" width="1024" height="542" data-path="images/energ/energ-data-completeness-meter-gap-timeline.png" />
</Frame>

Each segment is colored by coverage: a <Tooltip tip="A period where an expected bill is missing.">gap</Tooltip> shows light blue and an <Tooltip tip="Two bills that cover the same days.">overlap</Tooltip> shows yellow. For the full color legend, see [Data quality legend](/products/energ/reference/data-and-meter-fields#data-quality-legend).

Hover a segment to read **Service Type**, **Meter**, **Segment**, and **Period** in the tooltip.

Scroll below the chart for a table that alternates **Complete** rows (with **BILL** links and usage) and **Gap** rows (zero usage and no statement).

<Frame caption="Data Quality table with Complete and Gap rows">
  <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-data-completeness-meter-gap-table.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=27922b48da61e942fa84f679e2423c9d" alt="Meter Data Quality table for 8365020 03 showing alternating Complete rows with BILL statement type and kWh usage and Gap rows with zero usage between billing periods" width="1024" height="527" data-path="images/energ/energ-data-completeness-meter-gap-table.png" />
</Frame>

A **Gap** row between two **Complete** periods usually means EnerG expected a bill for those dates but none arrived. See [Building meters — Data Quality tab](/products/energ/buildings/meters#data-quality-tab) for column definitions and bill PDF links.

## Why gaps matter

Buildings below your completeness threshold drop out of benchmarking until coverage recovers. For why this rule protects rankings, see [Why completeness gates benchmarking](/products/energ/concepts/data-completeness#why-completeness-gates-benchmarking).

<h2 id="investigate-and-fix-gaps">
  Investigate and fix gaps
</h2>

<Steps>
  <Step title="Identify low-scoring buildings">
    Open [Portfolio Home](/products/energ/analytics/benchmarking) and check the **Data Completeness** KPI card. Click a building with a low score to review its detail panel.
  </Step>

  <Step title="Open the meter Data Quality tab">
    Go to [Building meters](/products/energ/buildings/meters), select the meter, and open **Data Quality**. Use the date range picker in the header to match the gap period. Confirm **Gap** segments on the chart and **Gap** rows in the table.
  </Step>

  <Step title="Diagnose the root cause">
    Match what you see to one of the causes below. Each cause points to the workflow that fixes it.
  </Step>

  <Step title="Upload bills or fix the source">
    When the gap is missing billing data, follow [Add new billing data](/products/energ/buildings/meters#add-new-billing-data) on the same meter detail page. Click **+ Add Meter Data**, enter usage and dates, and upload the bill PDF in **Upload Files** when you have it.

    For many gaps at once, use **Bulk Import** from the three-dot menu next to **+ Add Meter Data**. See [Bulk import meter data](/products/energ/buildings/meters#bulk-import-meter-data) for the Excel template workflow.
  </Step>

  <Step title="Confirm the gap closed">
    Return to the **Data Quality** tab after data syncs. **Gap** segments should turn **Complete**, and the building completeness score should rise on **Home**.

    <Check>
      Revisit completeness on [Portfolio meters](/products/energ/analytics/portfolio-meters) or the building **Data Quality** report when you finish.
    </Check>
  </Step>
</Steps>

### Common gap causes

<AccordionGroup>
  <Accordion title="Missing bills (no data from the provider for a period)">
    **What you see:** Light blue **Gap** segments on the timeline and **Gap** rows with **0.00** usage in the table.

    **What to do:** Upload or enter the missing period on [Building meters — Add new billing data](/products/energ/buildings/meters#add-new-billing-data). If the provider should have sent the bill automatically, check [Arcadia](/products/energ/data-sources/arcadia) **Statements** or [Alert center](/products/energ/data-quality/alert-center) for ingestion errors first.
  </Accordion>

  <Accordion title="Offline or stale data source credentials">
    **What you see:** Gaps across many meters that share one utility account, often with no new **BILL** rows for weeks.

    **What to do:** Open [Arcadia](/products/energ/data-sources/arcadia) at the portfolio or building level, review **Credentials** status, and re-authenticate or refresh the connection. After statements flow again, gaps close without manual entry when ingestion succeeds.
  </Accordion>

  <Accordion title="Incorrect service start or end dates">
    **What you see:** Long **Gap** bars at the start or end of the timeline, or **Complete** periods that do not match when the meter was actually active.

    **What to do:** Open the **Properties** tab on [Building meters](/products/energ/buildings/meters#properties-tab) and correct **Date Became Active** and **Date Became Inactive**. EnerG recalculates expected days in the completeness window after you save.
  </Accordion>

  <Accordion title="Meters not yet mapped to the building">
    **What you see:** Low building completeness while the meter list looks healthy, or bills exist in the portfolio but not on this building's **Meters** page.

    **What to do:** Assign meters from [Arcadia](/products/energ/data-sources/arcadia), [CSV uploads](/products/energ/data-sources/csv-uploads), [Manual entry](/products/energ/data-sources/manual-entry), or [KODE OS](/products/energ/data-sources/kode-os-data-source) using **Assign Meters** on each data source page. See [Building data sources](/products/energ/buildings/data-sources).
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Building meters" icon="gauge" href="/products/energ/buildings/meters#add-new-billing-data" arrow={true} cta="Open">
    Upload bills and fill gaps with **+ Add Meter Data**.
  </Card>

  <Card title="Data quality overview" icon="book-open" href="/products/energ/data-quality/data-quality-overview" arrow={true} cta="Read">
    Return to the data quality hub for alerts and meter comparisons.
  </Card>

  <Card title="Alert center" icon="bell" href="/products/energ/data-quality/alert-center" arrow={true} cta="Open">
    Triage billing issues with priorities, statuses, and resolution actions.
  </Card>

  <Card title="Building Energy — Data Quality" icon="zap" href="/products/energ/analytics/building-dashboards-energy#data-quality" arrow={true} cta="Open">
    Review meter coverage for every commodity on one building.
  </Card>
</CardGroup>