RIE Logos 2025



Building Data Portal


ENERGY STAR® Portfolio Manager® Connection Guide




Table of Contents

1. ENERGY STAR® Portfolio Manager® Overview

2. Initial ENERGY STAR Portfolio Manager Connection

2.1 Download your ENERGY STAR Property

2.2 Create a New ENERGY STAR Portfolio Manager Meter

2.3 Connect Your Building Between ENERGY STAR Portfolio Manager and the Building Data Portal

3. Troubleshooting Connection Issues

3.1 Connection Status: No Properties Shared

3.2 Connection Status: No Meters Shared

3.3 Finding your Building ID

4. ENERGY STAR Portfolio Manager Information

4.1 ENERGY STAR Portfolio Manager Metrics

4.1.1 What is an ENERGY STAR Score?

4.1.2 What is Energy Use Intensity (EUI)?

4.2 ENERGY STAR Portfolio Manager FAQs


1. ENERGY STAR® Portfolio Manager® Overview

ENERGY STAR® Portfolio Manager® is the United States Environmental Protection Agency’s (US EPA) online tool for measuring and tracking of energy and water consumption.

For information on how to sign up for ENERGY STAR Portfolio Manager, create a building profile, etc., please visit: https://www.energystar.gov/buildings/benchmark.

The Building Data Portal (BDP) provides monthly energy usage data that can be submitted directly to ENERGY STAR Portfolio Manager from within the BDP. This guide will present the steps to connect a building between the BDP and an existing ENERGY STAR Portfolio Manager profile. The high-level steps are as follows, with detailed instructions provided further below:

2.Initial ENERGY STAR Portfolio Manager Connection

You will have to take numerous steps to set up the initial connection between your building profile in the Building Data Portal (BDP) and ENERGY STAR Portfolio Manager.

We also recommend that a new meter is created in ENERGY STAR Portfolio Manager so that once you get to the meter mapping step, data is pushed into this new meter.

2.1 Download your ENERGY STAR Property

Once a connection is set up between the BDP and ENERGY STAR Portfolio Manager, any existing data in the ENERGY STAR Portfolio Manager meter that the BDP is mapped to will be overwritten. To prevent data from being inadvertently overwritten, it is good practice to download your current ENERGY STAR property in case the wrong meter is mapped.

To download your building’s current ENERGY STAR property:

  1. Log in to your ENERGY STAR Portfolio Manager account.
  2. In the Dashboard pane, click to open the property you wish to download. You will be taken to your property’s Summary tab.
  3. Click the Download Property to Excel link on the bottom-right of the page.
    1. An Excel copy of your building’s current ENERGY STAR profile will download. The different sections of your building’s ENERGY STAR profile will show up in separate tabs in the spreadsheet.
ENERGY STAR Property Download

2.2 Create a New ENERGY STAR Portfolio Manager Meter

Once a connection is set up between the BDP and ENERGY STAR Portfolio Manager, any existing data in the ENERGY STAR Portfolio Manager meter that the BDP is mapped to will be overwritten. To prevent any existing data from being overwritten, we recommend creating a new electric meter in ENERGY STAR Portfolio Manager to sync the aggregated data.

To create a new meter:

  1. On your property’s ENERGY STAR Portfolio Manager page, click on the Energy tab.
  2. Click on the Add a Meter button on the right-side of the page under the energy usage graph.
  3. ENERGY STAR Add Meter
  4. The Get Started Setting Up Meters page will display. Click the Electric box, the purchased from the grid box, and then put in “1” next to How Many Meters? Click the Get Started! button.
  5. ENERGY STAR Add Meter 2
  6. The About Your Meters page will display. Fill out a meter name, specify kWh as the units, and enter a first bill date. Click the Create Meters button.
  7. ENERGY STAR Add Meter 3
  8. The Select Meters to Include in Metrics page will display. Select the new energy meter you created and ensure “These meter(s) account for the total energy consumption...” box has been selected. Uncheck the box next to any pre-existing partial energy meters so that they are not used to compute metrics. Click the Apply Selections button.
  9. ENERGY STAR Add Meter 5

2.3 Connect Your Building Between ENERGY STAR Portfolio Manager and the Building Data Portal

  1. Launch the BDP portal from https://www.energyusage.rienergy.com
  2. Click the Login button
  3. Navigate to the Buildings page by clicking the Buildings menu on the left- side navigation pane of the Dashboard.
  4. From the main Buildings page, click on the desired building. You will be brought to the Overview tab where you will see an alert notifying you to connect your building to Portfolio Manager to see ENERGY STAR metrics.
  5. BDP Building Owner Overview Screen
  6. To setup/view the building’s connection with ENERGY STAR Portfolio Manager, click on the ENERGY STAR tab.
  7. To begin the ENERGY STAR Portfolio Manager connection process, click the Connect to Portfolio Manager button.
  8. ENERGY STAR Connect to ENERGY STAR
  9. You will then be asked to accept the ENERGY STAR Portfolio Manager Connection Terms of Connection. Click the checkbox to agree and click the Continue button.
  10. ENERGY STAR Add Meter
  11. Next, you will have to log into your ENERGY STAR Portfolio Manager account and take a few steps within that platform.
    1. Login at: https://portfoliomanager.energystar.gov/.
    2. Click on the Contacts link at the top-right of the page.
    3. Click Add New Contacts/Connections.
    4. ESPM Add Contact
    5. Search for username ‘rie-data-exchange'.
    6. ESPM Search Contact
    7. Click the Connect button next to “Rhode Island Energy Building Data Portal (rie-data-exchange)”
    8. ESPM Select Contact
    9. Click the checkbox next to the “Agreement” section, and click the Send Connection Request button.
    10. ESPM Send Connection Request
    11. You will then be brought to a screen confirming the successful connection with “Rhode Island Energy Building Data Portal (rie-data-exchange)”
    12. ESPM Connection Request Sent
    13. Wait a few minutes for Rhode Island Energy Building Data Portal (rie-data-exchange) to automatically accept your connection request. You can check your account connection status by clicking the “Contacts” top navigation link in Portfolio Manager.
      ESPM Search Contacts
      You will also receive a notification within Portfolio Manager that your connection was accepted. Click the “Notifications” top navigation link in Portfolio Manager, then click the “Notices” tab. Once the connection request has been accepted, proceed to the next step.
      ESPM Notifications
      If your connection is not accepted in five minutes, please contact the Building Data Portal Team at support@energyusage.rienergy.com.
    14. Click on the My Portfolio tab.
    15. In the Dashboard pane, click to open the property you wish to share with BDP.
    16. On the bottom-right of the building’s Summary tab, under “Sharing this Property,” click the Share button.
    17. ESPM Property Share
    18. On the Share (or Edit Access to) Properties page:
      1. Ensure that under “Select Properties,” “One Property” is selected from the drop-down and your desired property is chosen.
      2. Under “Select People (Account),” highlight “Rhode Island Energy Building Data Portal (rie-data-exchange).”
      3. Under “Choose Permissions” click the radio button next to “Personalized Sharing & Exchange Data (“Custom Orders”)” and click the Continue button.
      4. ESPM Property Share
      5. Click the “Exchange Data” radio button.
      6. ESPM Property Share
      7. A pop-up will appear that allows you to set access levels for different aspects of the ENERGY STAR Portfolio Manager profile:
        1. Paste the Building ID in the Building ID textbox. The Building ID can be found in the BDP on the Overview tab of your building.
        2. ESPM Property Share with Building ID
        3. Choose the “Read Only Access” radio button on the “Property Information” row and “Full Access” on the row for the meter(s) you would like to share with.
        4. Choose the “None” radio button on all other rows.
        5. ESPM Property Share
        6. Choose “No” for the “Share Forward” row.
        7. Click the Apply Selections & Authorize Exchange button.
        8. ESPM Property Share
        9. Click the Share Property(ies) button.
      8. Within a few minutes, the BDP should accept the building share and let you confirm the connection. If there are any issues connecting with the property, please contact the Building Data Portal Team at support@energyusage.rienergy.com
      9. ESPM Property Share
  12. Go back to the BDP and refresh the ENERGY STAR tab. You will need to confirm or reject the property and meter mapping. If the correct meter is displayed, click the Accept Mapping button. If something does not look correct, click the Reject Mapping button and contact Support@energyusage.rienergy.com.
  13. BDP Meter Mapping
    1. A pop-up will appear asking you if you are sure the meter mapping is correct. If the wrong ENERGY STAR Portfolio Manager meter is mapped to and it has pre-existing data, this meter will be overwritten.
    2. BDP Meter Mapping
  14. Once you confirm property and meter mappings, the BDP will begin its first data sync.
  15. Once the first sync completes, you will see the page change to an alert indicating when the last successful sync has been completed.
  16. BDP ESPM Sync Success
    1. Once your profiles are synced between the BDP and ENERGY STAR Portfolio Manager, any metrics errors present on your ENERGY STAR Portfolio Manager profile will also be pushed to the “Metrics Sync Status” section on your building’s ENERGY STAR tab in the BDP.

      BDP ESPM Sync Errors
      You cannot make changes within the BDP to resolve these errors. Errors must be addressed within the ENERGY STAR Portfolio Manager. For further information on ENERGY STAR Portfolio Manager alerts, please visit: https://www.energystar.gov/buildings/tools-and-resources/list_portfolio_manager_alerts
  17. Now that the ENERGY STAR Portfolio Manager building profile and meters have successfully synced with the BDP, the metrics on the building’s Overview page will populate. “Gross Floor Area,” “Energy Star Score,” “Source EUI,” and “Primary Functions” will now be populated with information from your ENERGY STAR Portfolio Manager building profile.
  18. BDP Overview Connected

3. Troubleshooting Connection Issues

This section will walk through troubleshooting steps should you have difficulty connecting to ENERGY STAR Portfolio Manager.


3.1 Connection Status: No Properties Shared

The ‘No Properties Shared’ message may indicate that your ENERGY STAR Portfolio Manager account or property has not yet been shared with Rhode Island Energy Building Data Portal (rie-data-exchange), or the property has been shared with the wrong Building ID.

To connect your ENERGY STAR account or to share a property with Rhode Island Energy Building Data Portal (rie-data-exchange), see Section 2.3 Connect Your Building Between ENERGY STAR Portfolio Manager and the Building Data Portal.

To modify the Building ID, you need to modify Rhode Island Energy Building Data Portal (rie-data-exchange)’s contact permissions.

To update the shared Building ID:

  1. Visit Portfolio Manager’s My Portfolio tab, then click into your building’s profile.
  2. In the bottom-right of the screen, under Sharing this Property, find Rhode Island Energy Building Data Portal (rie-data-exchange) and choose Edit Contact’s Permissions.
  3. ESPM Edit Contact Permissions
  4. Click Edit next to the Exchange Data radio button
  5. ESPM Edit Sharing
  6. Update the Building ID, then click Apply Selections & Authorize Exchange.
  7. ESPM Property Share

To remove the share:

  1. Visit Portfolio Manager’s My Portfolio tab, then click into the property profile.
  2. In the bottom-right of the screen, under Sharing this Property, find Energy Usage Data Web Services and choose Remove Contact’s access to Property from the actions dropdown menu.
  3. ESPM Remove Contact
  4. Reshare the property by following the steps found in Section 2.3 Connect Your Building Between ENERGY STAR Portfolio Manager and the Building Data Portal.

3.2 Connection Status: No Meters Shared

The No Meters Shared message indicates that you have connected your ENERGY STAR account and property to the BDP but a meter has not been shared or the wrong permissions have been granted.

To modify the share:

  1. Visit Portfolio Manager’s My Portfolio tab, then click into your building’s profile.
  2. In the bottom-right of the screen, under Sharing this Property, find Rhode Island Energy Building Data Portal (rie-data-exchange) and choose Edit Contact’s Permissions.
  3. ESPM Remove Contact
  4. Click Edit next to the Exchange Data radio button.
  5. Ensure that “Full Access” has been granted for the meters you wish to share. Then click Apply Selections & Authorize Exchange.
  6. Click Save Changes.
  7. Return to the BDP and refresh the building’s ENERGY STAR tab, which should now allow you to select your meter. If this takes longer than 5 minutes, please contact support at Support@energyusage.rienergy.com.
  8. BDP Meter Mapping

3.3 Finding your Building ID

Each building in your BDP portfolio will have a unique ID used for connecting to ENERGY STAR Portfolio Manager.

To find the building ID:

  1. Log into the BDP.
  2. Open the Buildings menu and search for the building, then click to open.
  3. Scroll down on the Overview page to the Building Information section. Your building ID is displayed.
  4. BDP Building Overview to Building ID

4. ENERGY STAR Portfolio Manager Information

ENERGY STAR Portfolio Manager is an interactive resource management tool that enables you to benchmark the energy use of any type of building. It is known as the industry standard for benchmarking commercial buildings. ENERGY STAR Portfolio Manager metrics allow you to compare your building’s energy use to a yearly baseline, national medians, or similar buildings in your profile.

4.1 ENERGY STAR Portfolio Manager Metrics

To view a building’s ENERGY STAR Score and building Source Energy Usage Intensity (EUI):

  1. Navigate to the Overview page for the building whose ENERGY STAR score and EUI you would like to view. The ENERGY STAR score and source EUI can be found at the top of the Overview page.

  2. OR
  3. Navigate to the Buildings page. From here, you can view the ENERGY STAR Score and Source EUI for each building in your building list.

4.1.1 What is an ENERGY STAR Score?

The 1 – 100 ENERGY STAR Score is populated once complete and accurate energy and property detail information is entered into an ENERGY STAR Portfolio Manager building profile. An ENERGY STAR score of 50 is the median, so a score above 50 means your building is performing better than 50% of its peers, while a score below 50 means your building is performing worse than 50% of similar buildings nationwide. A score above 75 or higher designates a building is a top performer, making it eligible for an ENERGY STAR building award. An ENERGY STAR score helps you assess how your building is performing and allows you to identify which buildings in your portfolio should be targeted for upgrades or recognition.

Further information on ENERGY STAR scores can be found here: https://www.energystar.gov/buildings/benchmark/understand_metrics/how_score_calculated

4.1.2 What is Energy Use Intensity (EUI)?

There are two types of energy usage intensity (EUI): Site EUI and Source EUI. Site energy is the amount of heat and electricity consumed by a building as you would see on your energy bills. Source energy represents the total amount of raw fuel that is required to operate the building, including transmission, delivery, and production losses. Energy Use Intensity is expressed as energy per square foot per year. Site EUI uses the site energy per square foot per year, while Source EUI uses the source energy per square foot per year.

The U.S. EPA has determined that Source EUI is the most equitable unit of evaluation, therefore, this is one of the metrics the BDP pulls back from an ENERGY STAR Portfolio Manager building profile.

For futher information on the difference between Site and Source energy, please visit: https://www.energystar.gov/buildings/benchmark/understand_metrics/source_site_difference

For further information on energy use intensity, please visit: https://www.energystar.gov/buildings/benchmark/understand_metrics/what_eui

4.2 ENERGY STAR Portfolio Manager FAQs

Many questions may arise as you use the ENERGY STAR Portfolio Manager, such as the best way to set up a mixed-use building, how to set up a campus of buildings, how to associate meters to get accurate metrics, etc. ENERGY STAR Portfolio Manager has extensive online resources to assist you:

It may be unclear when it is appropriate to reach out to the Building Data Portal Team for support at Support@energyusage.rienergy.com or consult ENERGY STAR Portfolio Manager Resources or reach out to the ENERGY STAR Portfolio Manager Help Desk. Please consult the table below for examples (please note, this is not an exhaustive list of situations that may arise):


Example Situation Reach out to BDP Support Consult ENERGY STAR Portfolio Manager Resources or Contact ENERGY STAR Portfolio Manager Help Desk
ENERGY STAR Portfolio Manager profile setup questions (inputting property information, creating meters, etc.) X
Issues sharing an ENERGY STAR Portfolio Manager profile with BDP (including meter access level questions) X
ENERGY STAR Portfolio Manager metrics alerts (including no ENERGY STAR score) X
ENERGY STAR Portfolio Manager login issues X
Altering the meters used in metrics X
Missing units in BDP Tenants tab X
RIE Logo