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

# Arcadia

> Connect Arcadia utility data at the portfolio level and manage bills, credentials, meters, accounts, and statements for buildings in EnerG

<Tooltip tip="Arcadia signs in to utility provider portals and retrieves bills, accounts, and meters on a schedule.">Arcadia</Tooltip> connects EnerG to utility providers so statements, accounts, and meters sync without manual exports. Add the integration once at the [portfolio level](/products/energ/analytics/portfolio-data-sources), then open **Arcadia** from [Building data sources](/products/energ/buildings/data-sources) to assign meters and accounts to each site.

## Add the Arcadia data source (portfolio)

You add Arcadia once per portfolio before you manage credentials or map meters at the building level.

<Steps>
  <Step title="Open Data Sources">
    In the portfolio left sidebar, click **Data Sources**. The page shows integrated data source cards and an **All Data Sources** list.

    <Frame caption="Data Sources page at the portfolio level">
      <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-data-sources-arcadia-nav.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=1054bae1977417a9aa3d7be139a201ef" alt="EnerG Data Sources page showing Utility Hub with Arcadia badge Manual Entry Virtual Entry Kode OS and CSV Upload source cards with left panel listing sources and Add Data Source button" width="1262" height="925" data-path="images/energ/energ-data-sources-arcadia-nav.png" />
    </Frame>
  </Step>

  <Step title="Add the source">
    Click **+ Add Data Source**. Select **ARCADIA** in the **API** dropdown. Enter **Credentials**, **Client Id**, and **Client Secret** from your Arcadia account, then click **Confirm**.

    <Frame caption="Add Data Source dialog with ARCADIA selected">
      <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-data-sources-arcadia-select.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=4c6af12f1a1d524db6416a985b249a94" alt="Add Data Source dialog showing ARCADIA selected with Credentials Client Id and Client Secret fields" width="1254" height="914" data-path="images/energ/energ-data-sources-arcadia-select.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  The Arcadia source appears as a **Utility Hub** card with an Arcadia badge after creation.
</Check>

## Open Arcadia from the building view

After portfolio setup, manage Arcadia for one building from the building **Data Sources** menu.

<Steps>
  <Step title="Select a building">
    From [Portfolio Home](/products/energ/analytics/benchmarking), open a building in the building view.
  </Step>

  <Step title="Open Arcadia">
    Expand **Data Sources** in the left sidebar. Under **All Data Sources**, click **Arcadia** (or **Utility Hub** when labeled that way).
  </Step>
</Steps>

The **Arcadia** detail page shows five tabs: **Bills**, **Credentials**, **Meters**, **Accounts**, and **Statements**. Use them to upload bills, connect provider logins, and link discovered meters and accounts to the building.

<Warning>
  Validate username and password on the utility provider portal before you enter them in EnerG. Invalid credentials delay collection until you fix them.
</Warning>

## Bills tab

Upload PDF utility bills when you need data that is not yet available from automated collection.

<Frame caption="Arcadia Bills tab with uploaded bill queue">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-bills.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=5a2f8cf0421e9d564309910bf5ab6c35" alt="Arcadia Bills tab with Search Bills field Add Bills button and table showing Uploaded date File name preview icon Provider Status Queued and Buildings Unassigned" width="1024" height="349" data-path="images/energ/energ-building-arcadia-bills.png" />
</Frame>

| Column        | What it shows                                                   |
| ------------- | --------------------------------------------------------------- |
| **Uploaded**  | Date the file was added                                         |
| **File**      | PDF filename with preview icon                                  |
| **Provider**  | Utility provider after OCR or processing                        |
| **Status**    | Processing state, such as **Queued**                            |
| **Buildings** | Assignment state, such as **Unassigned** until mapped to a site |

Click **+ Add Bills** to drag PDFs into the upload area. OCR extraction can take several hours. Assign processed bills to buildings when **Buildings** shows **Unassigned**.

## Credentials tab

Add provider login credentials so Arcadia can retrieve statements and discover accounts.

<Frame caption="Arcadia Credentials tab with connection status">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-credentials.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=4e6dd193646b46ed02ca526f91cd76de" alt="Arcadia Credentials tab with Search Credentials Add Credentials button and table showing Connection Success status Login And Data Discovery Success and Total Accounts counts" width="1024" height="343" data-path="images/energ/energ-building-arcadia-credentials.png" />
</Frame>

| Column             | What it shows                                                |
| ------------------ | ------------------------------------------------------------ |
| **Username**       | Portal login for the provider account                        |
| **Provider**       | Utility company name                                         |
| **Status**         | **Connection Success** or error state                        |
| **Status Details** | Detail message, such as **Login And Data Discovery Success** |
| **Total Accounts** | Accounts discovered under the credential                     |

### Add a credential

<Steps>
  <Step title="Click Add Credentials">
    On the **Credentials** tab, click **+ Add Credentials**.
  </Step>

  <Step title="Choose a provider">
    In **Search Providers**, find and select the utility, such as **City of Crystal Lake, Illinois**.

    <Frame caption="Add a new Credential provider list">
      <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-add-credential-providers.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=0613fddd6524b1b950f2e72156ebb8df" alt="Add a new Credential dialog with Search Providers list showing City of Crystal Lake City of Seattle Liberty Utilities and other utilities" width="655" height="644" data-path="images/energ/energ-building-arcadia-add-credential-providers.png" />
    </Frame>
  </Step>

  <Step title="Enter login details">
    Confirm the provider portal, then enter **Username** and **Password**. Use **Open Provider Portal** when you need to verify the login page.

    <Frame caption="Add a new Credential login form">
      <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-add-credential-login.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=405cad9ddc0be28666a9124e878d1632" alt="Add a new Credential form for City of Crystal Lake Illinois with Review Provider Details Open Provider Portal Username and Password fields and Submit button" width="648" height="385" data-path="images/energ/energ-building-arcadia-add-credential-login.png" />
    </Frame>

    Click **Submit**. Arcadia downloads available statements. Processing can take a few hours to one day depending on the provider.
  </Step>
</Steps>

| Status                 | Meaning                               |
| ---------------------- | ------------------------------------- |
| **Connection Success** | Login succeeded and discovery started |
| **In Progress**        | Arcadia is still processing           |
| **Failed**             | Invalid credentials or blocked access |

## Meters tab

Review discovered meters and assign them to the building.

<Frame caption="Arcadia Meters tab with meter list">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-meters.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=6b9344757d65cd8cee2fbd96e7cbc70a" alt="Arcadia Meters tab with Search Meters Assign Meters button and table with Meter Number Service Type Unit Account Numbers Provider Service Address and Active status" width="1024" height="548" data-path="images/energ/energ-building-arcadia-meters.png" />
</Frame>

The table lists each discovered meter with its level, service type, unit, account, and provider. For column definitions, see [Meter table columns](/products/energ/reference/data-and-meter-fields#meter-columns). For service type groups, see [Service types](/products/energ/reference/data-and-meter-fields#service-types).

Click **Assign Meters** to link meters to the open building.

<Frame caption="Add existing Meters dialog">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-add-meters.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=cf9eb921b7b712d8f829acc58aad293d" alt="Add existing Meters modal with Search Meters table showing Meter Number Service Type Provider Name Address checkboxes and pagination 1-20 of 220" width="815" height="471" data-path="images/energ/energ-building-arcadia-add-meters.png" />
</Frame>

Search meters, select checkboxes for meters that belong to the building, then click **Submit**. Meters appear on [Building meters](/products/energ/buildings/meters) after assignment and processing.

## Accounts tab

Review utility accounts discovered from credentials.

<Frame caption="Arcadia Accounts tab">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-accounts.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=35b316b574a65750f110df66921b7587" alt="Arcadia Accounts tab with Search Accounts Add Accounts button and table with Provider Name Status CONNECTION_SUCCESS or INACTIVE Last Statement Date and Active Yes" width="1024" height="355" data-path="images/energ/energ-building-arcadia-accounts.png" />
</Frame>

| Column                      | What it shows                           |
| --------------------------- | --------------------------------------- |
| **Account Number**          | Utility account identifier              |
| **Provider Name**           | Utility company                         |
| **Status**                  | **CONNECTION\_SUCCESS** or **INACTIVE** |
| **Provider Classification** | Source type, such as **PUBLISHER**      |
| **Last Statement Date**     | Most recent bill date                   |
| **Active**                  | Whether the account is active           |

Click **+ Add Accounts** to link accounts to the building.

<Frame caption="Add existing Accounts dialog">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-add-accounts.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=86cb734896f1cd6076ee69906dcc920c" alt="Add existing Accounts modal with searchable table of provider names status CONNECTION_SUCCESS or INACTIVE last statement dates and pagination 1-50 of 3895" width="830" height="473" data-path="images/energ/energ-building-arcadia-add-accounts.png" />
</Frame>

Select accounts with **CONNECTION\_SUCCESS** when possible, then click **Submit**.

## Statements tab

Browse bills Arcadia retrieved from connected providers. Use this tab to download statements for audits or cost review.

<Frame caption="Arcadia Statements tab">
  <img src="https://mintcdn.com/kodelabs/2xuyqDwhBYJ11inY/images/energ/energ-building-arcadia-statements.png?fit=max&auto=format&n=2xuyqDwhBYJ11inY&q=85&s=33cfbb09b1cf6249d3c106e107daece4" alt="Arcadia Statements tab with Search Statements and table showing Statement Date with view icon Type BILL Provider Enbridge Gas Due Date and Amount Due columns" width="1012" height="364" data-path="images/energ/energ-building-arcadia-statements.png" />
</Frame>

| Column             | What it shows                                              |
| ------------------ | ---------------------------------------------------------- |
| **Statement Date** | Bill date. Click the date or eye icon to open the document |
| **Type**           | Document type, such as **BILL**                            |
| **Provider**       | Utility company                                            |
| **Due Date**       | Payment due date                                           |
| **Amount Due**     | Billed amount                                              |

See [Utility cost analysis](/products/energ/finance/cost-analysis) for how finance teams use downloaded statements.

## Next steps

<CardGroup cols={2}>
  <Card title="Building data sources" icon="database" href="/products/energ/buildings/data-sources" arrow={true} cta="Open">
    Return to the building data sources overview.
  </Card>

  <Card title="Building meters" icon="gauge" href="/products/energ/buildings/meters" arrow={true} cta="Open">
    Review meters assigned to the building after mapping.
  </Card>

  <Card title="Portfolio data sources" icon="database" href="/products/energ/analytics/portfolio-data-sources" arrow={true} cta="Open">
    Manage portfolio-wide connections and other connectors.
  </Card>

  <Card title="CSV uploads" icon="file-spreadsheet" href="/products/energ/data-sources/csv-uploads" arrow={true} cta="Open">
    Bulk-load spreadsheet history when you have structured files.
  </Card>

  <Card title="Data sources and meters" icon="gauge" href="/products/energ/concepts/data-and-meters" arrow={true} cta="Read">
    Understand how bills and meters feed EnerG analytics.
  </Card>
</CardGroup>
