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

# Consumption analytics

> Aggregate consumption across all utility types with filtering and date presets.

<Tip>
  Need help in this area? See [Analytics FAQ](/docs/platform/analytics/faq).
</Tip>

Navigate to [**Analytics > Consumption**](https://dash.nectarclimate.com/analytics/consumption) for a unified view of consumption across every utility type in your portfolio.

<Note>
  Usage estimation is an optional module enabled for selected companies.
</Note>

## Usage basis

When usage estimation is enabled — or when persisted fills already exist in your data — eligible commodity sections on this page add a pinned **Usage basis** filter:

| Value                              | What totals include                                  |
| ---------------------------------- | ---------------------------------------------------- |
| **Actual and estimated** (default) | Collected site usage plus persisted estimation fills |
| **Actual only**                    | Collected source usage only                          |

The filter is shareable in the URL, stored in saved views, and applies as one page-level choice across every eligible commodity block on Consumption. Ineligible sections (for example when a commodity is out of scope) resolve to actual only and note the limitation.

**Usage basis** controls analytics totals, tooltips, summary footers, and exports. It is separate from **[Coverage basis](/docs/platform/glossary#coverage-basis)** on completeness, which controls whether fill-dependent months count as **Estimated** in the coverage timeline.

### Provenance and combined values

With **Actual and estimated** selected, KPIs and charts display the **combined** total (collected plus estimated). Tooltips, provenance footers, and spreadsheet exports also show the split:

* **Collected usage** — from bills and other source data
* **Estimated usage** — from persisted site-level fills

With **Actual only** selected, charts and totals use collected usage. Estimated amounts may still appear as reference when fills exist.

If a fill overlaps newly collected usage before the next estimation refresh, you may see a non-blocking warning that estimated usage overlaps collected usage. Rerun estimation in [**Settings > Company > Sites**](https://dash.nectarclimate.com/settings/company/sites/list) → site → **Estimation rules**. The warning prompts refresh — it does not mean totals are deduplicated at read time.

### Sub-site filters are actual only

Usage estimation applies to **whole-site commodity** usage. If you filter by meter tags, fuel type, waste material, waste stream, or another sub-site scope, **Usage basis** is disabled and totals use collected data only. See [Usage estimation](/docs/platform/data-quality/usage-estimation).

## Filters

Use the filter bar at the top of the page to control which data is visualized:

| Filter                | Description                                                                             |
| --------------------- | --------------------------------------------------------------------------------------- |
| **Usage basis**       | **Actual and estimated** or **Actual only** — when usage estimation applies (see above) |
| **Date Preset**       | Quick selections like **Last 12 Months**, **Year to Date**, or **Custom** range         |
| **Custom Date Range** | Start and end date pickers (available when Custom is selected)                          |
| **Sites**             | Multi-select to focus on specific sites                                                 |
| **Utility Types**     | Multi-select to include or exclude specific commodities                                 |

Filters apply instantly — charts update as you adjust selections.

## Commodity sections

The main area displays a **Commodity Section** for each selected utility type. Each section includes:

* A **timeseries chart** showing consumption over the selected date range.
* **Summary metrics** for the period (total consumption, average, peak).

Sections appear in a consistent order: electricity, gas, water, waste, and fuel. Deselecting a utility type in the filter sidebar hides its section.

**See also:** [Usage estimation](/docs/platform/data-quality/usage-estimation), [Glossary — Usage basis](/docs/platform/glossary#usage-basis)

## Drill-down to site composition

On **year-over-year** and **consumption trend** charts, you can open the **[Aggregation Inspector](/docs/platform/sites/overview#aggregation-inspector)** for the month you click, or use the chart widget’s actions menu to inspect the current filter range. The inspector shows how site-level totals are built from meter-level data for the selected commodity and period (same concept as on the [Sites](/docs/platform/sites/overview) dashboard).

## Exporting

Use the **Export** dropdown in the top-right corner to download the chart data as a spreadsheet. The export respects all active filters, so you get exactly the data you see on screen.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why is a whole commodity block missing?">
    Each block corresponds to a utility type you include in the **Utility types** filter. If a type is
    deselected, that section is hidden. Re-add the type to bring the section back.
  </Accordion>

  <Accordion title="Do site and date filters apply to every section?">
    Yes. **Sites**, **Date preset** / **Custom date range**, and **Utility types** apply to all commodity
    sections on the page. Adjusting filters updates every visible chart together.
  </Accordion>

  <Accordion title="How do I investigate a spike or drop in the portfolio view?">
    Use drill-downs where available: on supported charts you can open the
    [Aggregation Inspector](/docs/platform/sites/overview#aggregation-inspector) for a month, or use the
    chart’s actions menu to inspect the current range. Cross-check the same period in
    [Data Quality](/docs/platform/data-quality/completeness) if you suspect missing bills.
  </Accordion>

  <Accordion title="Will my export match what I see?">
    Yes. **Export** uses the same filter state as the on-screen charts, so the downloaded file reflects
    your current sites, dates, utility types, and **Usage basis**. Exports include collected,
    estimated, and combined columns when estimation applies.
  </Accordion>

  <Accordion title="Why is Usage basis disabled?">
    Estimation fills apply to whole-site commodity usage. Sub-site filters such as meter tags, fuel
    type, or waste material disable **Usage basis** and show collected usage only. See
    [Usage estimation](/docs/platform/data-quality/usage-estimation).
  </Accordion>

  <Accordion title="What order do commodity sections appear in?">
    Sections follow a fixed order—electricity, gas, water, waste, and fuel—so teammates see a
    predictable layout. Only types you include in the filter appear.
  </Accordion>

  <Accordion title="Where can I get more help with analytics?">
    See [Analytics FAQ](/docs/platform/analytics/faq) for troubleshooting empty charts, exports, and
    reconciliation questions. For data that still looks wrong after checking filters, email
    [support@nectarclimate.com](mailto:support@nectarclimate.com) with the page URL and timeframe.
  </Accordion>
</AccordionGroup>