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

# Report Builder

> Create, schedule, and export custom energy, cost, and emissions reports from EnerG

You create and run configurable reports from EnerG for energy, water, waste, cost, and emissions metrics. In the [portfolio view](/products/energ/get-started/navigation#portfolio-view), open `Report Builder` in the left sidebar. You define scope, time ranges, metrics, and export formats, then download files for compliance, ESG, and internal updates.

## Navigate to Reports

Click `Report Builder` in the portfolio left sidebar. The **Reports** page lists every saved report in the portfolio with the subtitle *All Reports in the portfolio.*

<Frame caption="Reports page with search, filters, and the reports table">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-reports-list.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=d6e4d00820b8339f4edba953bbd1cb69" alt="Reports page with Search field, Author Report Type Export Format and Schedule filters, date range picker, Create New Report button, and a table with Name Author Email Type Export Formats Schedule Created At Updated At and edit and delete actions" width="1024" height="443" data-path="images/energ/energ-report-builder-reports-list.png" />
</Frame>

Click `+ Create New Report` to open the five-step **Report Builder** wizard. To download or change a saved report, click the **edit** icon on that row.

### Filter and search reports

| Control               | Purpose                                     |
| --------------------- | ------------------------------------------- |
| **Search**            | Find reports by name                        |
| **Author**            | Filter by report owner                      |
| **Report Type**       | Filter by configuration type                |
| **Export Format**     | Filter by output format such as XLSX or PDF |
| **Schedule**          | Filter by scheduled or manual reports       |
| **Select date range** | Limit the list by created or updated dates  |

### Reports table columns

| Column             | Description                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------- |
| **Name**           | Report title                                                                                  |
| **Author**         | Person who created the report                                                                 |
| **Email**          | Author email address                                                                          |
| **Type**           | Configuration type such as `Custom Configuration`                                             |
| **Export Formats** | Output badges such as `.XLSX` and `.PDF`                                                      |
| **Schedule**       | Whether automated delivery is enabled                                                         |
| **Created At**     | Date the report was created                                                                   |
| **Updated At**     | Date of the last change                                                                       |
| **Actions**        | **Edit** opens the report to download or update settings; **Delete** removes the saved report |

## Create a report

The **Report Builder** wizard has five steps: **Basic Setup**, **Dataset & Scope**, **Time Configuration**, **Export Configuration**, and **Review & Submit**.

<Steps>
  <Step title="Basic Setup">
    Choose how you build the report. Select **Custom Configuration** to configure the report step by step with dataset selection, time ranges, metric breakdowns, and export settings.

    **Feature Based** (PDF Builder with drag-and-drop blocks) may appear as **Coming Soon** in your workspace.

    <Frame caption="Report Builder step 1 Basic Setup with Custom Configuration selected">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-basic-setup.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=8126002979c74cc3d14b7200d7550ec8" alt="Report Builder Basic Setup step with Progress 1 of 5, Custom Configuration selected with blue border, Feature Based marked Coming Soon, and Next button" width="1024" height="529" data-path="images/energ/energ-report-builder-basic-setup.png" />
    </Frame>

    Click `Next`.
  </Step>

  <Step title="Dataset and Scope">
    Select the data type and hierarchy level for the report.

    | Dataset type  | Purpose                                |
    | ------------- | -------------------------------------- |
    | **Portfolio** | Include all assets in the portfolio    |
    | **Region**    | Limit the report to selected regions   |
    | **Building**  | Limit the report to selected buildings |
    | **Meter**     | Limit the report to selected meters    |

    <Frame caption="Report Builder step 2 Dataset and Scope with Portfolio selected">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-dataset-scope.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=1135e46e3bb9cb74ffbdb3ebe33231a8" alt="Report Builder Dataset and Scope step with Progress 2 of 5, Portfolio radio selected showing All assets included, and Region Building and Meter options below" width="1024" height="532" data-path="images/energ/energ-report-builder-dataset-scope.png" />
    </Frame>

    Click `Next`.
  </Step>

  <Step title="Time Configuration">
    Define granularity, date range, and comparison logic.

    **Comparison type** options include **Year over year**, **Quarter over Quarter**, and **Month over Month**.

    Set **Time granularity** (for example, **Annual**) and enter **Start Year** and **End Year** for the reporting window.

    <Frame caption="Report Builder step 3 Time Configuration with Year over year and Annual selected">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-time-configuration.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=2abf90aa8d09364fa8d1a0f2d0228c73" alt="Report Builder Time Configuration step with Year over year selected, Annual granularity, Start Year 2020 and End Year 2026, and Previous and Next buttons" width="1024" height="537" data-path="images/energ/energ-report-builder-time-configuration.png" />
    </Frame>

    Click `Next`.
  </Step>

  <Step title="Export Configuration">
    Configure the report name, structure, metrics, formats, and optional scheduling.

    Enter a **Name** for the report. Choose **Breakdown hierarchy**: **By Portfolio**, **By Building**, or **By Region**.

    Under **Metric Outputs**, check the metrics to include:

    * **Consumption**
    * **Cost**
    * **GHG Emissions**
    * **Data Completeness**

    <Frame caption="Report Builder Export Configuration with breakdown hierarchy and metric outputs">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-export-configuration.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=1b4c5cd9a71444b0a0925c24dcd8f10f" alt="Report Builder Export Configuration showing Name field, Breakdown hierarchy with By Building selected, and Metric Outputs with Consumption and Cost checked" width="1024" height="535" data-path="images/energ/energ-report-builder-export-configuration.png" />
    </Frame>

    Set presentation and delivery options: toggle **Include Accruals**, choose **XLSX** or **PDF**, and turn on **Enable Scheduling** for recurring runs. For what each option does, see [Report export options](/products/energ/reference/reporting-and-alerts#report-export).

    <Frame caption="Export Configuration with XLSX selected and scheduling toggle">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-export-formats.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=84829ad3ea3708a92d8327e3eb202846" alt="Export Configuration section with Include Accruals toggle on, XLSX selected, PDF unselected, Enable Scheduling toggle off, and Previous and Submit buttons" width="1024" height="549" data-path="images/energ/energ-report-builder-export-formats.png" />
    </Frame>

    Click `Submit` to save the configuration and start generation.
  </Step>

  <Step title="Review and Submit">
    On **Review & Submit**, EnerG compiles your datasets, applies time settings, and formats the output. A progress message appears while the report generates. This step typically takes 10 to 30 seconds.

    <Frame caption="Report Builder Review and Submit with report generation in progress">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-review-submit.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=6888aebd7f1fadc155c25878ec8b73ed" alt="Report Builder Review and Submit step 5 of 5 with Generating Your Report loading spinner and message about compiling datasets and formatting output" width="1024" height="524" data-path="images/energ/energ-report-builder-review-submit.png" />
    </Frame>

    When processing completes, the page summarizes your choices in three panels: **Dataset & Scope**, **Time Configuration**, and **Export Configuration**. Confirm scope, date range, comparison type, metrics, breakdown, accruals, and export formats before you download.

    <Frame caption="Review and Submit summary with Download XLSX and Done buttons">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-report-builder-review-complete.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=7e36c959289c674c731fe45a0f0d05e0" alt="Review and Submit step showing Dataset and Scope Portfolio Entire Portfolio, Time Configuration Annual 2020 to 2026 Year over Year, Export Configuration with Consumption and Cost metrics By Building breakdown Include Accruals Yes XLSX format, and Download XLSX and Done buttons" width="1024" height="511" data-path="images/energ/energ-report-builder-review-complete.png" />
    </Frame>

    Click `Download XLSX` to save the workbook, or click `Done` to return to the **Reports** list.
  </Step>
</Steps>

### Example report workbook

Download the [example Report Builder export (XLSX)](/downloads/energ-report-builder-example.xlsx) to review layout, summary tabs, and chart data before you run a report in your workspace.

The example export uses **Portfolio** scope, **Annual** granularity, a **2020–2026** date range, **Year over year** comparison, **By Building** breakdown, and **Consumption** and **Cost** metrics with accruals included.

For every sheet the workbook contains and what each holds, see [Report Builder workbook sheets](/products/energ/reference/reporting-and-alerts#workbook-sheets).

<Tip>
  Open **Table of Contents** first in a new export. It lists every sheet and notes which tabs include chart data.
</Tip>

## Download or edit an existing report

Saved reports stay on the **Reports** table until you delete them. To run an export again or change settings, open the report from the **edit** icon.

<Steps>
  <Step title="Open the report">
    On the **Reports** page, click the **edit** (pencil) icon on the report row. The **Report Builder** wizard opens on **Review & Submit** with the saved configuration summary.
  </Step>

  <Step title="Download the file">
    Click `Download XLSX` or `Download PDF` (when configured) to export the report with current data. EnerG uses the saved scope, time range, metrics, and formats.
  </Step>

  <Step title="Adjust settings optional">
    To change the report, click `Previous` and move through the wizard steps. You can update any option from report creation: **Basic Setup**, **Dataset & Scope**, **Time Configuration**, or **Export Configuration**. Click `Submit` when you reach **Export Configuration** to regenerate, then download from **Review & Submit**.
  </Step>
</Steps>

<Info>
  You do not download existing reports directly from the table row. Use the **edit** icon to open **Review & Submit** and download from there.
</Info>

## Delete a report

Click the **delete** (trash) icon on a row to remove a saved report you no longer need.

<Warning>
  Deleting a report removes its saved configuration. Downloaded files on your computer are not affected.
</Warning>

## Use reports for compliance and ESG

Teams use EnerG exports for compliance reporting, ESG submissions, and internal stakeholder updates.

You remain responsible for confirming that exported fields meet each program's rules. EnerG supplies the data; your team validates fit for each filing.

<Tip>
  Store export settings you reuse each quarter so column names and units stay consistent across filing cycles.
</Tip>

## Related exports

Detailed meter exports and comparison workflows also live under **Data Quality** in EnerG. Open [Data quality overview](/products/energ/data-quality/data-quality-overview) when you need raw interval or register detail beyond standard summary reports.

## Next steps

<CardGroup cols={2}>
  <Card title="Portfolio budget and planning" icon="dollar-sign" href="/products/energ/analytics/portfolio-budgets" arrow={true} cta="Open">
    Export budget planning data separately from Report Builder when you need monthly plan workbooks.
  </Card>

  <Card title="Portfolio certifications" icon="award" href="/products/energ/analytics/portfolio-certifications" arrow={true} cta="Open">
    Track certification compliance alongside energy and emissions reports.
  </Card>

  <Card title="Data completeness" icon="circle-check" href="/products/energ/data-quality/data-completeness" arrow={true} cta="Open">
    Confirm data coverage before you rely on rolled-up report metrics.
  </Card>

  <Card title="Portfolio Home" icon="house" href="/products/energ/analytics/benchmarking" arrow={true} cta="Open">
    Return to portfolio rankings after you configure recurring exports.
  </Card>
</CardGroup>
