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

# Sites FAQ

> Troubleshooting site setup, views, analytics visibility, and site-level data.

Use this page to troubleshoot **Sites** setup and monitoring issues.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why does a site show no analytics data?">
    Confirm the site has active meters and recent data from connections or uploads. A site without
    mapped meters will not show commodity analytics. Also check that you have selected a date range
    and commodity in the site dashboard filters.
  </Accordion>

  <Accordion title="My bulk site upload failed. How do I fix it?">
    Review the row-level validation errors shown in the upload dialog. Common issues:

    * **Missing required columns** — `name` and `address` columns must be present (column names
      are case-insensitive but must match the template).
    * **Invalid frequency** — frequency columns accept only `MONTHLY`, `QUARTERLY`, `ANNUALLY`,
      or blank. Other values from the wider Frequency enum (`DAILY`, `WEEKLY`, etc.) are not
      configurable for site-required-data.
    * **Invalid email** — `dataOwnerEmails` must be a comma-separated list of valid email
      addresses (max 10).
    * **Out-of-range numbers** — `occupancyPercent` must be between 0 and 100; `area` must be
      positive.
    * **Bad dates** — `dataCollectionStartDate` and `dataCollectionStopDate` must be `YYYY-MM-DD`.

    Fix the highlighted rows in your spreadsheet and re-upload. Start with a small sample file
    if failures are widespread.
  </Accordion>

  <Accordion title="What is the difference between regional, table, and map views?">
    The **Regional** view (default) groups sites into a hierarchical tree by geographic path, making
    it easy to browse by location. The **Table** view is a flat, paginated list with sorting and
    action menus — best for searching across all sites. The **Map** view plots sites geographically
    so you can see physical distribution at a glance. All three views share the same filters.
  </Accordion>

  <Accordion title="Why are some sites missing from the map?">
    The map plots sites using coordinates derived from their address. If a site has no address or
    an address that could not be geocoded, it appears in the "Sites without valid address" table
    below the map. Update the address in **Settings** > **Company** > **Sites** to fix this.
  </Accordion>

  <Accordion title="What does the Aggregation Inspector do?">
    It shows how a site's monthly usage total is composed from individual meter readings. You can
    see which meters contributed, how much each provided, and whether any were excluded (for
    example, duplicates or untracked meters). The inspector is available in the Usage,
    Completeness, and Inspect tabs of the site dashboard.
  </Accordion>

  <Accordion title="Why can I not archive or update a site?">
    This is usually a permissions issue or a validation error. Verify your role and required fields,
    then retry. If it still fails, send support the site ID and exact action attempted.
  </Accordion>

  <Accordion title="How should I structure sites for multi-building campuses?">
    Model each physically distinct billing location as a separate site, then use tags for grouping
    (for example, region, business unit, or portfolio).
  </Accordion>

  <Accordion title="Can I filter sites by custom dimensions?">
    Yes. Use site tags for consistent filtering and segmentation. You can also filter by geographic
    path, which organizes sites hierarchically by location. Configure tag taxonomies in company
    settings before large imports.
  </Accordion>

  <Accordion title="Where did the site sidebar go?">
    The old master-detail layout with a left sidebar has been replaced by three portfolio views
    (Regional, Table, Map) and a richer site dashboard. You can still open any site by clicking its
    row or using the eye icon to preview it in a side panel.
  </Accordion>
</AccordionGroup>

## Related sites docs

<CardGroup cols={2}>
  <Card title="Sites overview" icon="book-open" href="/platform/sites/overview">
    Core workflows for site views, dashboards, and aggregation inspection.
  </Card>

  <Card title="Company settings" icon="building" href="/platform/settings/company-settings">
    Site tags, bulk actions, and company-level site configuration.
  </Card>
</CardGroup>