Skip to main content
Buildings
Updated over 2 months ago

Manage and add new buildings for your portfolio.

👍 This article will help you:

  • Navigate your buildings to view dashboards, profiles, points, and more

  • Add or edit a single building

  • Add or edit multiple buildings at once

To access Buildings, go to Buildings on the left side menu.

📘 Building dashboards, profiles, points, and more

Select a building from the grid or table to access building data and other important information. Then, select the tabs located below the building's name: Dashboards, Profile, Points, etc.

Add new buildings

To add a single building or multiple buildings, select the 'Add a building' button.

Add a single building

Select 'Add a single building'. Provide all required information under Building Details and Area. Optional information may be provided at a later time. When finished, select the 'Create building' button at the bottom of the page.

Add multiple buildings

Select 'Add multiple buildings'. Then, use the Batch Building Upload tool to upload a CSV file of all your new buildings at once. Download the buildings template CSV file provided, and enter each building's information in the required format in your preferred CSV editor.

Add buildings CSV template contains the following fields:

Field

Description

displayName

The building's name. Each name should be easily distinguishable from other buildings.

type

The building's type, such as office, school, or government facility. See here for a full list of available building types.

manualPointsOnly

TRUE indicates your building will contain manual points ONLY (includes batch uploads).

FALSE indicates your building will contain automated points (utility bills, real-time meters and sensors, API, etc.)

Address

The building's street, city, and state/territory.

countryCode

The building's two letter country code

postalCode

The building's postal code. Postal code is used to determine the nearest weather station. See below for a list of countries that don't require a postal code.

area

The total building area in square feet. Area can be used as a normalization metric.

highestFloor (optional)

The number of floors in your building.

occupancy

The building's average daily occupancy. Occupancy is used to calculate per person values and baseline models.

yearBuilt (optional)

The year your building was built

vendorBuildingId (optional)

A unique ID that you use to identify your building

If entered, you will be able to organize your buildings by Building ID in addition to the display name.

Postal Code Exceptions

Some countries aren't included in Google's geocoding service, which means that postal codes for those countries can't be used in Atrius. For the following countries only, leave the Postal code field blank when creating buildings:

Country Code

Country Name

AO

Angola

AG

Antigua and Barbuda

AW

Aruba

BS

Bahamas

BH

Bahrain

BD

Bangladesh

BZ

Belize

BJ

Benin

BO

Bolivia

BW

Botswana

BR

Brazil

BF

Burkina Faso

BI

Burundi

CM

Cameroon

CF

Central African Republic

CL

Chile

CN

China

CO

Colombia

KM

Comoros

CG

Congo

CD

Congo, The Democratic Republic of the

CK

Cook Islands

CR

Costa Rica

CI

Cote D'Ivoire

DJ

Djibouti

DM

Dominica

DO

Dominican Republic

EC

Ecuador

EG

Egypt

GQ

Equatorial Guinea

ER

Eritrea

FJ

Fiji

TF

French Southern Territories

GM

Gambia

GH

Ghana

GD

Grenada

GT

Guatemala

GN

Guinea

GY

Guyana

HK

Hong Kong

IE

Ireland

IL

Israel

KE

Kenya

KI

Kiribati

KP

People's Republic of Korea

KR

Korea, Republic of

LA

Laos

MO

Macao

MW

Malawi

MY

Malaysia

ML

Mali

MT

Malta

MR

Mauritania

MU

Mauritius

MX

Mexico

MS

Montserrat

MM

Myanmar

NR

Nauru

NL

Netherlands

NU

Niue

PA

Panama

PE

Peru

PL

Poland

PT

Portugal

QA

Qatar

RW

Rwanda

KN

Saint Kitts and Nevis

LC

Saint Lucia

ST

Sao Tome and Principe

SA

Saudi Arabia

SC

Seychelles

SL

Sierra Leone

SB

Solomon Islands

SO

Somalia

ZA

South Africa

SR

Suriname

SY

Syrian Arab Republic

TZ

Tanzania, United Republic of

TH

Thailand

TO

Tonga

TT

Trinidad and Tobago

TV

Tuvalu

UG

Uganda

AE

United Arab Emirates

UY

Uruguay

VU

Vanuatu

VN

Viet Nam

YE

Yemen

ZW

Zimbabwe

Additional column headers can be added to the CSV if you'd like to create Estimated electricity or Estimated natural gas points. Learn more

When finished, select the 'Upload CSV' button at the bottom of the page.

A banner at the top of the page will inform you that the upload is processing and to await an email that will indicate whether the upload was successful or not. If any errors were detected in the file (ex. unidentified postal code, incorrectly spelled building type), then the email will have a "errors.csv" attached detailing the issues. You may use this same file to fix the errors and re-upload the file.

Edit buildings

To edit a single building or multiple buildings, go to Buildings. To facilitate batch edit actions, switch to 'Table' view at the top right of the grid of building photos.

Use the Search or Filter to narrow your selection to a subset of buildings to edit. Select the desired buildings using the checkboxes at the left side of the table, then select Actions > Edit buildings.

If editing fewer than 500 buildings, then you will be taken to a batch edit page, where you may select or enter information across multiple fields. These same fields are available on each building's Profile page. When finished, select 'Save buildings'.

Edit buildings: CSV

If editing more than 500 buildings, then in the Actions menu, select "Edit building CSV." This will take you to a page, similar to the Batch Building Creation page, where you can download a CSV, enter building information you'd like to edit, then re-upload it.

The Edit buildings CSV contains four fields that are not included on the Upload CSV (see above):

Field

Description

uuid

This is Atrius' unique identifier for your building object. If this uuid is edited or removed your edits may fail or be pointed to the incorrect building object.

estimated_electricity

estimated_natural_gas

principalActivityType

Create or edit estimated energy points. Learn more

❗️Deleting a building cannot be undone

Deleting a building will remove all point data, bill point data, and metadata related to the building. Before you can delete a building, you must first remove the association between the building and any points or bill points: Go to Points and Bills, select the point(s) and bill point(s) displayed, then change the Building field on the corresponding point or bill point profile pages.

Video tutorial



Did this answer your question?