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

# Portfolio meters

> Manage and monitor utility meters across your portfolio in EnerG

Open `Meters` in the [portfolio view](/products/energ/get-started/navigation#portfolio-view) left sidebar. The sections below follow the order you use in the product: review the main page, filter the table, assign meters, create virtual meters, then manage linked meters.

For meter detail at a single site, switch to the [building view](/products/energ/get-started/navigation#building-view) and open [Building meters](/products/energ/buildings/meters).

## Meters page

The portfolio **Meters** page title reads **Meters** with the subtitle *Manage and monitor all meters across your portfolio.*

### Page actions

| Action                   | Purpose                                                                           |
| ------------------------ | --------------------------------------------------------------------------------- |
| `Go to Linked Meters`    | Open the [Linked meters page](#linked-meters-page) to view, edit, or create links |
| `+ Create Virtual Meter` | Open the panel to [create a virtual meter](#create-a-virtual-meter)               |
| `Filters`                | Open filter controls for the meters table                                         |
| `Assign Meters`          | Start the workflow to [assign meters](#assign-meters-to-buildings) to a building  |

<Frame caption="Portfolio Meters page with summary cards, filters, and the meters table">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-overview.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=baa7816fd8b668b62ca221286a2bd65c" alt="Portfolio Meters page showing Total Meters, Meters Not Assigned, Data Completeness at 96 percent, and Inactive Meters summary cards, search and filter bar, Assign Meters action, and a table with Building, Meter Number, Account Number, Account Status, Level, Service Type, Unit, Currency, Status, Data Completeness, Data Source, and Provider Name columns" width="1024" height="583" data-path="images/energ/energ-portfolio-meters-overview.png" />
</Frame>

### Summary cards

Four cards summarize portfolio health above the table.

| Card                    | What it shows                                                     |
| ----------------------- | ----------------------------------------------------------------- |
| **Total Meters**        | Count of meters across all buildings                              |
| **Meters Not Assigned** | Meters that still need a building assignment                      |
| **Data Completeness**   | Portfolio-wide completeness percentage with a `View Details` link |
| **Inactive Meters**     | Meters marked inactive                                            |

Click `View Details` on **Data Completeness** to open a drill-down by building, account, and month. For how EnerG scores coverage and why gaps matter, see [Data completeness](/products/energ/concepts/data-completeness).

<Warning>
  Mark meters **inactive** when a utility account closes or the provider issues a new meter number. Inactive meters stay available for historical regressions and M\&V, but they should not count against current completeness if no new bills are expected. Leave inactive meters unassigned or excluded so they do not inflate gap alerts.
</Warning>

<Frame caption="Data Completeness page with expandable building rows and monthly percentages">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-data-completeness.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=1800a5870410a48cde22d164e0ac21ab" alt="Data Completeness page with Search buildings field, Buildings filter, year selector set to 2026, and an expanded Beacon Hill Complex row showing account ACT-101295 and meters MTR-101295-E01, MTR-101295-G01, and MTR-101295-W01 with monthly completeness percentages in green and red" width="1024" height="579" data-path="images/energ/energ-portfolio-meters-data-completeness.png" />
</Frame>

On the Data Completeness page, click a **building name** to open [Building information](/products/energ/buildings/building-information). Click a **meter name** to open meter details.

### Meters table

The table lists every meter in the portfolio. Each column header supports sorting. Use pagination at the bottom to move through large result sets. Click a **Building** or **Meter Number** link to open [Building information](/products/energ/buildings/building-information) or meter details. For what each column shows, see [Meter table columns](/products/energ/reference/data-and-meter-fields#meter-columns).

## Filter meters

Use the search field above the table to find meters by number or name. Click `Filters` to show the filter row. The button highlights when filters are active.

<Frame caption="Portfolio Meters with the filter row open and Utility Hub selected as Data Source">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-filters.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=f871b5c343506bf8d1d025b643d10614" alt="Portfolio Meters page with Search meters field, Filters button active, filter row showing Meter Type, Building, Service Type, Scope, and Data Source dropdowns with Utility Hub selected, summary cards for Total Meters, Meters Not Assigned, Data Completeness at 91 percent, and Inactive Meters, and Assign Meters button visible" width="1024" height="265" data-path="images/energ/energ-portfolio-meters-filters.png" />
</Frame>

| Filter           | Purpose                                        |
| ---------------- | ---------------------------------------------- |
| **Meter Type**   | Narrow by utility, interval, or virtual meters |
| **Building**     | Limit results to one or more sites             |
| **Service Type** | Filter by commodity                            |
| **Scope**        | Filter by site-level or submeter scope         |
| **Data Source**  | Limit to meters from a specific feed           |

<Info>
  You must select a **Data Source** before `Assign Meters` becomes available.
</Info>

## Assign meters to buildings

Use `Assign Meters` to link meters from a data source to a building. You filter by **Data Source**, open the workflow, pick the building, then select meters from that feed.

<Steps>
  <Step title="Filter by Data Source">
    Click `Filters` to show the filter row. Select a **Data Source** such as `Utility Hub`. `Assign Meters` stays disabled until you choose a data source.
  </Step>

  <Step title="Click Assign Meters">
    Click `Assign Meters` next to the filter row. The **Add Meters** dialog opens.
  </Step>

  <Step title="Choose a building and click Next">
    On the **Add Meters** page, search for a building by name. Select one row in the table, then click `Next`.

    The table lists **Building**, **Type**, and **Address** for each site.

    <Frame caption="Add Meters dialog to select a building before meter assignment">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-add-meters.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=32dfcff66be1cbc3c89a3272b72e8b38" alt="Add Meters modal with Search field containing kode, a table with Building Type and Address columns showing KODE 1420 Office selected as Office at 1420 Washington Boulevard Detroit, and Cancel and Next buttons" width="680" height="528" data-path="images/energ/energ-portfolio-meters-add-meters.png" />
    </Frame>
  </Step>

  <Step title="Select meters and click Submit">
    On the **Add existing Meters** page, search for meters if needed. Check each meter you want to assign. Review **Meter Number**, **Service Type**, **Account Number**, **Provider Name**, and **Address**, then click `Submit`.

    <Frame caption="Add existing Meters dialog with selected meters ready to submit">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-add-existing.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=a2a9878bb88519efafedd7692ff7a9fa" alt="Add existing Meters modal with subtitle Select the meter you want to add to your building, Search Meters field, and a table with Meter Number Meter Name Service Type Account Number Provider Name and Address columns showing Electric and Natural Gas meters from DTE Energy checked with Submit button" width="941" height="564" data-path="images/energ/energ-portfolio-meters-add-existing.png" />
    </Frame>

    <Check>
      Assigned meters appear in the portfolio **Meters** table and in [Building meters](/products/energ/buildings/meters) for that site.
    </Check>
  </Step>
</Steps>

## Create a virtual meter

Click `+ Create Virtual Meter` in the top-right corner of the Meters page. <Tooltip tip="A virtual meter calculates usage from other meters instead of a direct utility feed.">Virtual meters</Tooltip> calculate usage from other meters instead of a direct utility feed.

Choose a **Calculation Method**:

| Method               | Use when                                                                                       |
| -------------------- | ---------------------------------------------------------------------------------------------- |
| **Custom Formula**   | You define an equation from other meters after you set service type, unit, currency, and scope |
| **Percentage Split** | You allocate a fixed share of one or more source meters                                        |

<Frame caption="Create Virtual Meter with Custom Formula selected">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-virtual-meter-formula.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=fcb5973906dafc6ae1fe692e4d56692b" alt="Create Virtual Meter panel with Custom Formula radio selected, fields for Name, Meter Number, Building, Service Type, Unit, Currency, Scope, and Description, and an info banner to select Service Type, Unit, Currency and Scope to configure the equation" width="1024" height="721" data-path="images/energ/energ-portfolio-meters-virtual-meter-formula.png" />
</Frame>

<Frame caption="Create Virtual Meter with Percentage Split selected">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-virtual-meter-split.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=5fef31f7a021f4a01575925e01a1a187" alt="Create Virtual Meter panel with Percentage Split radio selected and an info banner to select Service Type, Unit, Currency and Scope to configure the percentage split" width="1024" height="719" data-path="images/energ/energ-portfolio-meters-virtual-meter-split.png" />
</Frame>

<Steps>
  <Step title="Enter meter details">
    Provide **Name**, **Meter Number**, **Building**, **Service Type**, **Unit**, **Currency**, **Scope**, and an optional **Description**.
  </Step>

  <Step title="Configure the calculation">
    For **Custom Formula**, build the equation after required fields are set. For **Percentage Split**, define the share across source meters when EnerG prompts you.
  </Step>

  <Step title="Submit">
    Click `Submit`. The virtual meter appears in the portfolio table.
  </Step>
</Steps>

## Linked meters page

Click `Go to Linked Meters` on the Meters page to open the **Linked Meters** view. The page title reads **Linked Meters** with the subtitle *Manage the meters linked to your portfolio.*

<Frame caption="Linked Meters page with search, filters, and the links table">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-linked-overview.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=1e1ac67b514ee0b30792d50dcddb24a0" alt="Linked Meters page with Search linked meters field, Filters button, Building Service Type and Date Range dropdowns, Link Meters button in the top right, and a table with Name Description Service Category Service Type Primary Meter Linked Meters Created At Updated At columns and edit and delete action icons" width="1024" height="652" data-path="images/energ/energ-portfolio-meters-linked-overview.png" />
</Frame>

Use the **Search linked meters...** field to find links by name. Click `Filters` to show **Building**, **Service Type**, and **Date Range** filters when you need to narrow a large portfolio.

### Read link details

The table lists every meter link with sortable columns.

| Column               | Description                                                                      |
| -------------------- | -------------------------------------------------------------------------------- |
| **Name**             | Label you gave the link when you created it                                      |
| **Description**      | Optional notes that explain why the meters are linked                            |
| **Service Category** | Broad group such as Energy or Waste                                              |
| **Service Type**     | Commodity such as Electric or Natural Gas                                        |
| **Primary Meter**    | Main meter in the relationship. Click the meter ID to open that meter’s details. |
| **Linked Meters**    | Secondary meter tied to the primary. Click the meter ID to open its details.     |
| **Created At**       | Date the link was created                                                        |
| **Updated At**       | Date of the last change                                                          |
| **Actions**          | Row controls to edit or delete the link                                          |

Click a meter ID under **Primary Meter** or **Linked Meters** when you need to review billing data, completeness, or properties for that meter before you change the link.

### Edit or delete a link

Use the row actions at the right end of each link.

* **Edit** (pencil icon) — Open the **Edit Meter Link** modal to change the name, description, linked meters, or which meter is primary.
* **Delete** (trash icon) — Remove the link. The individual meters stay in EnerG; only the relationship is removed.

<Frame caption="Edit Meter Link modal with available meters and timeline workspace">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-linking-edit.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=d78504d99bc5e3657df3dbc8fbd3acc3" alt="Edit Meter Link modal with Name and Description fields, Available Meters panel organized by Electric service type with checkboxes, Timeline Workspace showing two meters with Primary toggles one on and one off, and Close and Update buttons" width="1024" height="580" data-path="images/energ/energ-portfolio-meters-linking-edit.png" />
</Frame>

<Steps>
  <Step title="Open the link for editing">
    On the Linked Meters page, click the **edit** icon on the link row.
  </Step>

  <Step title="Update the link">
    Change **Name** or **Description** if needed. In **Available Meters**, select or clear meters to add or remove them from the **Timeline Workspace**. Turn **Primary** on for the meter that should drive the stitched timeline.
  </Step>

  <Step title="Save changes">
    Click `Update`. The table refreshes with your changes.
  </Step>
</Steps>

## Link meters

Meter links stitch timelines across related feeds so analytics stay continuous when accounts or meter numbers change. Create a new link from the Linked Meters page.

<Steps>
  <Step title="Click Link Meters">
    On the Linked Meters page, click `Link Meters` in the top-right corner. The **Meter Linking** modal opens.

    <Frame caption="Meter Linking modal before meters are added to the workspace">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-linking-create.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=9ae22d3c3063f7db5e28155010cc0e5a" alt="Meter Linking modal with Name and Description fields, Available Meters panel with Organize by Data Source and a scrollable meter list, empty Timeline Workspace with Drag Meters to Link instruction, and Close and Create buttons" width="1024" height="645" data-path="images/energ/energ-portfolio-meters-linking-create.png" />
    </Frame>
  </Step>

  <Step title="Enter a name and description">
    Fill in **Name** and **Description** so operators can recognize the link later.
  </Step>

  <Step title="Select two meters">
    In **Available Meters**, search or organize the list by **Data Source** or **Service Type**. Select the first meter you want to link, then select the second meter. You can check meters in the list or drag them into the **Timeline Workspace**.

    <Frame caption="Meter Linking workspace with meters selected and a primary meter designated">
      <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-meters-linking-workspace.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=f8922f0be7c2794ad1d703b147b138dd" alt="Meter Linking modal with Name and Description fields, Available Meters organized by Service Type on the left, Timeline Workspace on the right showing Cardboard meter with Primary toggle, and Close and Create buttons" width="1024" height="638" data-path="images/energ/energ-portfolio-meters-linking-workspace.png" />
    </Frame>
  </Step>

  <Step title="Choose the primary meter">
    In the **Timeline Workspace**, turn **Primary** on for the meter that should anchor comparisons. Leave **Primary** off for the secondary meter.
  </Step>

  <Step title="Click Create">
    Click `Create`. A success message confirms the link. The new row appears on the Linked Meters table.
  </Step>
</Steps>

<Tip>
  Link meters that represent the same physical account across a meter change or data source migration. Keep service type and scope aligned so stitched timelines do not mix unrelated commodities.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Portfolio data sources" icon="database" href="/products/energ/analytics/portfolio-data-sources" arrow={true} cta="Open">
    Connect feeds before you assign meters across the portfolio.
  </Card>

  <Card title="Building meters" icon="gauge" href="/products/energ/buildings/meters" arrow={true} cta="Open">
    Review and edit meters after you open a building.
  </Card>

  <Card title="Alert center" icon="bell" href="/products/energ/data-quality/alert-center" arrow={true} cta="Open">
    Resolve data quality alerts for portfolio meters.
  </Card>

  <Card title="Portfolio Home" icon="house" href="/products/energ/analytics/benchmarking" arrow={true} cta="Open">
    Select a building to continue work in the building view.
  </Card>

  <Card title="Data sources and meters" icon="gauge" href="/products/energ/concepts/data-and-meters" arrow={true} cta="Read">
    Understand how feeds and meters organize portfolio data.
  </Card>

  <Card title="Data and meter fields" icon="table" href="/products/energ/reference/data-and-meter-fields" arrow={true} cta="Look up">
    Look up meter columns, service types, and status values.
  </Card>
</CardGroup>
