What It Is

The electrical hierarchy is a map of how your site is wired: which devices sit inside which. Arranging it correctly is what keeps your site's energy numbers accurate.

Your site is organized as a tree that mirrors the physical wiring. A main feed powers sub-panels and sub-mains, which in turn power individual loads such as an air conditioner, lighting, or an EV charger. Each device is measured by one or more sensors.

There are two separate hierarchies per site, one for each direction, and they never mix:

• Consumption - what the site uses.
• Generation - what the site produces, for example solar.

Why It Matters

The organization directly affects what you see in reports and dashboards.

• Accurate totals. Only top-level feeds count toward the site total. A device placed under a main is already included in that main's reading - leaving it at the top level as well would double-count it.
• Visibility of hidden loads. For any device, its reading minus the readings of the devices beneath it reveals the "other" load in that area - the part with no dedicated sensor.

A Simple Example

Imagine a main that reads 100 kWh:

If the air conditioner were mistakenly left at the top level instead of under the main, the site total would wrongly read 160 kWh instead of 100 kWh.

How to Arrange the Hierarchy

Open Configuration › Electrical hierarchy for the site. The screen has two working panels: the Device catalog on the left, where you find devices, and the hierarchy in the middle, where you place them.

1. Find the Device

In the Device catalog:

• Search by device name or panel name.
• Filter by category, by electrical panel, or both.
• Sort the list with the Name A-Z dropdown - options are Name A-Z, Name Z-A, Category, Panel, and Phase count. Sorting by Category or Panel groups the list under headings for each one, which is useful for finding everything on a panel at a glance.
• Tick a device to pick it up. Tick several to move them together, and hold Shift while clicking to select a whole run of rows at once.

2. Place It

Once something is selected, the hierarchy shows you where it can go. There are three ways to move it:

• Click to place - click directly on a compatible row to drop the device there.
• Drag - drag the device from the catalog straight onto a compatible parent.
• Move under... - opens a searchable list of every parent that can accept the device, grouped by main incomer. Available either from the selection bar at the bottom of the screen, or by right-clicking any row in the hierarchy for a Move under... shortcut.

3. Review and Save

Every move is listed in the Change Log on the right, with a timestamp. Undo on the most recent entry puts those devices back exactly where they were. Save applies the changes. Reset discards everything you have not saved yet.

4. See the Whole Hierarchy at Once

Select the tree icon at the top of the Device catalog to open Full hierarchy: every device in the current direction shown as one diagram. Switch between Horizontal and Vertical layout, use Collapse branches or Reset view to tidy a large tree, and scroll to zoom or drag to pan. Click any device to expand or collapse its branch. This view is for reading, not editing.

Placement Rules

A device can only sit under a compatible parent:

• The same direction. A consumption device goes under consumption, generation under generation. The two hierarchies never mix.
• An equal or higher number of phases. A single-phase device fits under a three-phase parent. A three-phase device does not fit under a single-phase one.
• Not under itself or anything already beneath it, which would create a loop.
• Not its current parent. If a device already sits under a parent, that parent isn't offered again, since moving it there would change nothing.

You don't have to remember these - when devices are selected, the hierarchy dims every row that can't take them and shows why on hover.

Related Articles

• Getting Started
• Bridges and Sensors
• Meters & Loggers