> ## 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.

# Analytics FAQ

> Troubleshooting charts, filters, exports, and analytics data visibility.

Use this page to troubleshoot analytics views and chart interpretation.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why is my analytics page empty?">
    Confirm your company has sites with active meters and processed usage data. New setups may take
    time before the first full charts appear.
  </Accordion>

  <Accordion title="CSV export from analytics fails with date errors. Why?">
    Most analytics exports require a valid date range. Set explicit start/end dates in filters before
    exporting.
  </Accordion>

  <Accordion title="Why do analytics totals differ from bill-level totals?">
    Analytics may use calendarized periods and standardized aggregation rules. Compare with
    methodology docs when reconciling.
  </Accordion>

  <Accordion title="Can I compare sites with different utility mixes?">
    Yes, but comparability depends on selected filters and available commodity coverage per site.
    Align scope and date ranges for fair comparisons.
  </Accordion>

  <Accordion title="How do I debug sudden spikes or drops?">
    Unexpected numbers usually have one of these causes — work through them in order:

    1. **Bill with an open issue** — Bills with unresolved [data quality issues](/docs/platform/data-quality/issues#when-is-data-excluded) don't count toward analytics, even though their values still appear on the bill and meter rows (marked with an amber warning triangle). Resolving the issue adds the usage back, which can cause a sudden jump.
    2. **Duplicate meter not marked** — If two meters track the same physical device, usage is double-counted until one is [marked as duplicate](/docs/platform/data-inventory/meter-detail#handling-duplicate-meters).
    3. **Superseded usage** — Usage rows linked as revisions are excluded from usage and emissions totals. Historical site cost allocation can still retain those rows.
    4. **Meter assigned to the wrong site** — Usage appears on the wrong site's charts. Check the meter's site assignment in [meter detail](/docs/platform/data-inventory/meter-detail).
    5. **Meter not tracked** — An untracked meter doesn't count toward analytics totals, though its own rows still show usage and cost. If it should be tracked, update its tracking status from the [account detail](/docs/platform/data-inventory/account-detail) page.
    6. **Missing bill** — A gap in collection (connection error, late utility posting) creates a zero-usage month. Check [Data Completeness](/docs/platform/data-quality/completeness) for coverage gaps.
    7. **Unit conversion** — If a bill arrives in different units than previous bills (e.g., MWh vs kWh), the converted value may look unexpected. See [Units and conversions](/docs/platform/methodology/units).
    8. **Calendarization effect** — A bill spanning two months is [prorated](/docs/platform/methodology/calendarization) across them. Short or long billing periods can create apparent spikes or dips at the boundary.

    Use the site dashboard's aggregation inspector to drill into which meters and bills contributed to a specific month's total.
  </Accordion>

  <Accordion title="Where do I go if charts look wrong but source data looks correct?">
    Review [Methodology](/docs/platform/methodology/overview) for calendarization and allocation logic, then email
    [support@nectarclimate.com](mailto:support@nectarclimate.com) with the chart URL and a few example
    records so the team can reproduce the scope.
  </Accordion>

  <Accordion title="How does Consumption analytics differ from electricity, gas, and other commodity pages?">
    The Consumption page rolls every utility type into one portfolio view with shared filters (date
    preset, sites, utility types). Commodity pages focus on a single utility with that commodity’s KPIs
    and layouts. Use Consumption when you want one place to compare commodities; use a commodity page
    for deeper, type-specific metrics.
  </Accordion>

  <Accordion title="Why did a commodity section disappear on Consumption?">
    Each section matches an active **Utility type** filter. If you clear a commodity from the filter
    sidebar, its section hides. Add the type back to see it again.
  </Accordion>

  <Accordion title="What is the Aggregation Inspector and when should I use it?">
    From year-over-year or consumption-trend charts (and from related shortcuts), the inspector breaks
    down how a monthly total is built from [meter](/docs/platform/glossary#meter) contributions—similar to
    the tool on [Sites](/docs/platform/sites/overview). Use it when a portfolio total looks surprising and you
    need to see which sites and meters contributed.
  </Accordion>

  <Accordion title="Does the Consumption chart export include everything on screen?">
    Yes. The **Export** control downloads data that matches your current filters, so the file aligns
    with what the charts show for that selection.
  </Accordion>

  <Accordion title="Can I use keyboard shortcuts in chart widgets?">
    Many analytics widgets support actions from their menu (for example fullscreen or opening the
    inspector). Exact options depend on the widget; open the **actions** menu on the chart card to see
    what is available for that view.
  </Accordion>
</AccordionGroup>

## Related analytics docs

<CardGroup cols={2}>
  <Card title="Analytics overview" icon="book-open" href="/docs/platform/analytics/overview">
    Hub page and commodity-level navigation.
  </Card>

  <Card title="Consumption analytics" icon="chart-line" href="/docs/platform/analytics/consumption">
    Portfolio-level consumption trends.
  </Card>

  <Card title="Electricity analytics" icon="bolt" href="/docs/platform/analytics/electricity">
    Electricity-specific dashboards and metrics.
  </Card>

  <Card title="Methodology overview" icon="diagram-project" href="/docs/platform/methodology/overview">
    Understand how monthly metrics are calculated.
  </Card>
</CardGroup>