AES HUB User Manual

AES HUB User Manual

Welcome. This manual is for Analyst Users. Pick a task below, or search for a keyword.

Getting started

Signing in

Finding your work

Drawing reports

Reports

User management

Workflow

Help and feedback

Before you start

This page is a short orientation. It tells you what the AES HUB is, who this manual is for, what you need to sign in, and the words you will see most often.

All HUB versions


What the AES HUB is

The integrated AES HUB and SiteView application named Product of the Year at the Housebuilder Awards 2024

The AES HUB is a digital platform for UK housebuilders. It captures, stores, and reports the energy and building data for every job an energy assessor delivers on your behalf. The HUB replaces the PDF-and-spreadsheet exchange that used to sit between housebuilder and assessor with a live, structured record that both sides can interrogate at any time.

The HUB connects to the other services energy assessors run. SAP calculations, air testing, and photographic evidence (AES SiteView) all land in the HUB as files attached to the right plot, in the right job, under the right region.


Who this manual is for

This manual covers the AES HUB for all users. It is being written page by page. The topics ready today are the ones most users meet first:

Topics for administrators (onboarding, permissions, client configuration) and for other roles will be added over time. Pages marked coming soon on the home page will appear as they are written.


What you need before you sign in

If you have all three, head to Set up your account and sign in for the first time.


Key terms you will see

The HUB uses the same small vocabulary across every page. Learn these once and the rest of the manual reads easily.

For a deeper explanation of the tier tree, see Understanding the Tier Structure.


If you get stuck

The 👍 / 👎 buttons at the bottom of every page send feedback straight to the team.


What next


Feedback

Was this page helpful?

Set up your account and sign in for the first time

You will finish your one-off registration and land on the HUB dashboard, ready to use.

HUB v2.1+


Before you start


Steps

  1. Open the welcome email and click the PC link to open the sign-in page in your browser.

    Sign-in screen with E-mail and Password fields
  2. Type your email address and the one-time password from the invite, then click Login.

  3. On the password setup screen, type a new personal password.

    Password setup screen with strength meter showing Acceptable and green confirm tick

    Tip. Use three random words joined together, for example correct-horse-battery. Memorable for you, hard to guess for anyone else. See the NCSC three random words guidance for worked examples. Save the password in your password manager or browser if it is safe to do so.

  4. Watch the strength bar under the password field. Keep typing until it reaches at least Acceptable.

  5. Retype the password in Confirm Password. A green tick confirms the two match.

  6. Click Login.

    Confirmation reading “Your password has been set. Please sign in using it.”
  7. You are now back at the sign-in screen. Enter your email and your new password, then click Login.

  8. The HUB emails you a 6-digit PIN from no-reply@aes-hub.co.uk.

  9. Type the PIN into the six boxes on screen, then click Login.

    2FA screen with six empty boxes and “We sent a 6-digit code to your email.”
  10. Read the End User Licence Agreement and Privacy Policy, then click Agree.

    Terms & Conditions screen with Agree and Do not agree buttons

    Warning. Clicking Do not agree ends your registration. You cannot use the HUB without agreeing to the EULA and Privacy Policy.

  11. You land on the HUB dashboard. Registration is complete.

    Tip. Your session stays signed in for 7 days on this device. You will not need to sign in again during that window, unless we release an update or you sign out manually. Each device (laptop, tablet, phone) counts as a separate session.


Tips


What next


Feedback

Was this page helpful?

Sign in

You will sign into the HUB and land on your dashboard.

HUB v2.1+


Before you start


Steps

  1. Open the HUB sign-in page in your browser.

    Sign-in screen with E-mail and Password fields
  2. Type your email address and password, then click Login.

    Tip. Forgot your password? See Reset your forgotten password.

  3. The HUB emails you a 6-digit PIN from no-reply@aes-hub.co.uk.

  4. Type the PIN into the six boxes on screen, then click Login.

    2FA screen with six empty boxes and “We sent a 6-digit code to your email.”

    Tip. PIN not arriving? Wait 1 to 2 minutes, then check your spam folder. If it still has not arrived, click Back to login page and try again to trigger a new PIN.

  5. You land on the HUB dashboard.

    Tip. Your session stays signed in for 7 days on this device. You will not need to sign in again during that window, unless we release an update or you sign out manually.


What next


Feedback

Was this page helpful?

Reset your forgotten password

You will reset a forgotten password and sign back into the HUB.

HUB v2.1+


Before you start


Steps

  1. On the sign-in screen, click Forgot password?.

    Sign-in screen with Forgot password link
  2. Type your registered email address, then click Next.

    Password-reset email entry form
  3. The HUB confirms your request on screen. Close the browser tab and open your inbox.

    Password-reset acknowledgement screen
  4. Open the email from AES-HUB with the subject AES HUB - Password Reset and click Reset your password.

    Warning. The reset link expires 1 hour after the email is sent. If it expires, repeat steps 1 to 3 to trigger a new one.

  5. Type a new password. The strength meter must reach Acceptable. Confirm it in the second field.

    Set new password form

    Tip. You can reuse your old password if you want to. The HUB does not block password reuse.

  6. Click Login. You land back at the sign-in screen. Sign in using your email and the password you just set.


Tips


What next


Feedback

Was this page helpful?

Your first report, end to end

This is the hand-holding walkthrough for a brand-new user. Eight steps, from the welcome email landing in your inbox to a Completions Report open in Excel. We use one worked example all the way through: the job AES7770 East Hill, Chatham.

If you have already signed in once and want the mechanics in isolation, see Drawing a report instead.

All HUB versions


Before you start


Steps

  1. Open the welcome email and click the activation link.

    Welcome email from AES HUB Portal Admin with activation link

    The email comes from hubadmin@aessc.co.uk with the subject [AES HUB] You have been invited. Click the activation link inside.

    See Set up your account and sign in for the first time for the full first-time-setup detail, including what to do if the invite has expired.

  2. Set your password and confirm.

    Password setup screen with strength meter

    The activation link opens a password-setup screen. Type a strong password, confirm it, then click Login. The strength meter should reach Acceptable at minimum, Great for a passphrase such as three random words.

    See Set up your account for password tips and the National Cyber Security Centre’s “three random words” approach.

  3. Sign in with the 6-digit PIN.

    Six-box PIN entry screen with the PIN emailed from no-reply@aes-hub.co.uk

    Re-enter your email and new password. The HUB emails you a 6-digit PIN from no-reply@aes-hub.co.uk. Type the PIN into the six boxes and click Login. On first sign-in only you also accept the Terms and Conditions.

    See Sign in for the routine sign-in flow you will use from now on, and what to do if the PIN does not arrive.

  4. Find AES7770 from the dashboard.

    Dashboard main search bar at the top of the page

    You land on the dashboard. The fastest route to a known job is the main search bar at the top of the page: type AES7770 and click the matching result.

    Alternatively you can browse the Jobs list (cogwheel → Jobs) or walk down the tier tree from a developer to a region to a job. See Your dashboard, Finding a job, and Understanding the Tier Structure for those paths.

  5. Open Analytics on the job page and pick the Completions Report.

    Analytics dropdown open on a Tier 5 job page showing the available reports

    The job page for AES7770 opens. In the header, click the arrow next to Analytics to open the reports dropdown. Pick Completions Report.

    See The job page for everything else on this page (Key Facts, Plot List, files), and Drawing a report for the Analytics mechanic at every tier.

  6. Accept the default filters and click Apply.

    Completions Report with the Filter Settings panel on the left and a Please set filters prompt on the canvas

    The Completions Report opens with a Filter Settings panel on the left. The defaults are sensible for a first run: EPC mode, last 3 months for the date range, 2021 for Part L Building Regulations, AES7770 already loaded under Jobs.

    Click Apply at the bottom of the panel. The HUB runs the report. For a single job this returns in seconds.

    See Adjusting filters for what each filter does and how to combine them when you want a narrower or wider cut.

  7. Read your first report on screen.

    Populated Completions Report table for AES7770, one row per plot, with the headline pass-mark columns visible

    The table fills the right-hand pane. Each row is a plot in AES7770. The headline columns to read first are the three pass-mark percentages: DER TER %-impr., DPER TPER %-impr., and DFEE TFEE %-impr. Positive numbers mean the plot is passing.

    See Completions Report for what every column means, and Shared middle columns for the actual-vs-notional building concept that sits behind DER, TER, and the rest of the D / T pairs.

  8. Click XLSX to export to Excel.

    At the top of the report page, click the XLSX button. The HUB downloads a .xlsx file to your browser’s download folder. Open it in Excel. The same data you saw on screen is now yours to share, sort, or chart.

    Click Back at the top of the report page to return to the AES7770 job page when you are done.


Tips


What next


Feedback

Was this page helpful?

Your dashboard

You will recognise the layout of the HUB landing page and know how to get from it to the tools and jobs you need.

HUB v2.3+


Before you start


Steps

  1. Sign in. You land on the dashboard.

    The HUB dashboard after sign-in

    The dashboard has three areas: the top bar (visible on every screen), the Job Results block, and the Notification List block.

  2. Look at the top bar. It is visible on every screen in the HUB.

    Top bar with main search field, logo, plus icon, notifications icon, cogwheel, and user chip

    Left to right: main search field, AES HUB logo, plus icon, notifications icon, cogwheel, user chip (your initials).

    Note. The set of icons shown may vary depending on your user permissions and your organisation’s subscription. The baseline set above is present for every user.

  3. Use the main search field to find anything in the HUB.

    Main search field at the top of the HUB

    It searches across the whole HUB and returns matches for job numbers, client project numbers, site names, and any registered alternative names for a site.

    Why alternative names matter. Construction sites often carry several names: a planning name, a project name, a sales name, and so on. The site is logged in the HUB under the name the regional assessor chose, which may not be the name the developer uses. Alternative names bridge this gap so the site is findable by any of its known names.

    Top tip. If you want an alternative name added to a site, contact your assessor.

  4. Click the AES HUB logo from anywhere in the HUB to return to this landing page.

  5. Click the plus icon to open a Create section.

    Plus icon clicked, Create section visible with no actions for most users

    Create is a section heading. The actions that sit under it are permission-based and only available to registered assessors. For most users the heading is visible but no actions appear underneath.

  6. The notifications icon is a shortcut to your Notification List (the same list shown at the bottom of the dashboard).

    Notifications are raised when:

    • A BREL needs your signature
    • A file has been shared with you
    • A photo has been uploaded in SiteView or FireView (if your organisation uses them)
  7. Click the cogwheel to open the Manage section.

    Cogwheel menu showing Manage heading with Jobs and Clients grouped under it

    Manage is a section heading. Grouped under it are Jobs (the full jobs list) and Clients (the full clients list).

  8. Click the user chip (your initials) to open your account menu.

    User chip menu showing your name, Profile, and Sign out

    The menu shows your full name at the top, followed by Profile (link to your profile page) and Sign out.

    Stay signed in for 7 days. On your own device, you do not need to sign out each time. Your session remains active for 7 days, even if you close the browser. This is by design to save you from re-entering your password and PIN every day.

    When to sign out. If you are working on a computer or device that is not your own (a shared machine, a colleague’s laptop, a public terminal), always use Sign out when you finish. Only a hard sign out ends the session. Closing the browser does not.

  9. Scroll to the Job Results block. It is a preview of the jobs you have access to.

    Job Results block with filter row, table, and pagination

    The table has five columns: Job, CPN, Plots, Developer/Region/Site, Actions. The Developer/Region/Site column shows where each job sits in the Tier Structure. See The Tier Structure for what each tier means.

    Note. The Status and Type filters above the table are being developed. You can ignore them for now. The Search field on the filter row already works and searches within the current job list.

  10. Navigate to a job from here in one of three ways:

    Show all link highlighted on the Job Results block
    • Type a job number, job name, or site name into the main search at the top of the screen (recommended for a specific job)
    • Click Show all to open the full Jobs list (recommended when browsing)
    • Go to a region first, which narrows the list of jobs shown

    Tip. Do not flip through pagination page by page. The list can run to dozens of pages. Use search or region-based navigation instead.

  11. Scroll to the Notification List block.

    Notification List block with default filters

    This is the same list reached from the notifications icon in the top bar. The default filters show unread messages from the last month. See Working with notifications (coming soon) for detail.


Tips


What next


Feedback

Was this page helpful?

Understanding the Tier Structure

You will understand how the HUB organises work into tiers, how your permissions scope what you can see, and how to navigate from a developer down to a single job.

HUB v2.3+


Before you start


The five tiers

The HUB organises every job under a five-tier hierarchy. Each tier groups the one below it.

# Tier Example What it groups
1 Developer a housebuilder The client organisation at the top of the tree.
2 Division Eastern A grouping of regional offices within a developer.
3 Region North Thames A specific regional office.
4 Site (voluntary) (a named development across multiple phases) A physical development that energy assessors deliver across several phases. Each phase is a separate job.
5 Job AES2391 Collaton St Mary, Torbay A single job or phase of a Site, owned by one energy assessor.

Why the Site tier exists. Phases of the same development are often commissioned one at a time, sometimes with different energy assessors working on each phase. To the developer it is one site; in the HUB each phase is an independent job. The Site tier groups those sibling-phase jobs so they read as a single development. Site is voluntary. A job can sit directly under a Region with no Site in between.


Permissions and roles

Two separate systems decide what you can do in the HUB.

The two combine. A user with the Analyst role and Tier 3 permission on North Thames can draw reports for any job in North Thames, but cannot see jobs in other regions.


Steps

  1. Click the cogwheel in the top bar, then Clients.

    Cogwheel menu with Jobs and Clients grouped under Manage

    The Clients page is the main entry point to the Tier Structure. It lists every tier you have access to.

  2. Look at the Clients list.

    Clients list page with rows showing tier lineage

    Each row represents a tier. Columns are Client (the tier name with its breadcrumb lineage), Type (Developer, Division, Region, or Site), and Actions.

    The Roman numeral on the left of each row shows the tier level: I for Developer, II for Division, III for Region, IV for Site.

    What you will see. Your view is scoped by permission. If you sit on one Region, you see your Region and everything below it. Tiers above your permission are shown in the breadcrumb for context but are not clickable.

  3. Filter the list by Type to show a single tier level.

    Type filter dropdown open showing Tier 1 to 4

    Tier 5 (Job) is not listed here. Use the Jobs page (cogwheel → Jobs) or the dashboard for job-level work.

  4. Use the task bar to refine the view.

    Clients list task bar showing Search, display count, and display format icons
    • Search filters the list by name.
    • Display count (10 / 25 / All) sets how many rows show per page.
    • Display format (lines / columns / squares) changes the layout. This feature is most useful for reports and is available on many HUB pages.
  5. Click any row to open that tier’s detail page. A tier detail page has two parts.

    Top. Key information for the tier (E-mail, Post Code, Town, Address) and two action buttons: Back to clients and Analytics.

    Tier 1 Developer detail page, top half: Key information and action buttons

    Bottom. The child tiers and jobs attributed to this tier, split across two tabs: Clients (n) and Jobs (n).

    Tier 1 Developer detail page, bottom half: Clients tab with child tier rows

    Note on the Clients tab. The tab is always labelled Clients, whether the child tiers beneath it are Divisions, Regions, or Sites. The label does not rename itself to match the child tier.

  6. Walk down the tree by clicking a child in the Clients tab.

    Tier 3 Region detail page showing Clients (0) and Jobs (9) tabs

    Each click narrows the scope. In this example a Region shows Clients (0) and Jobs (9), no Sites beneath it, and nine jobs allocated directly to the Region.

  7. Walk up the tree by clicking a segment of the breadcrumb at the top of the page.

    Each segment is a link. Clicking takes you to that tier’s detail page.

  8. Use the Analytics button to draw a report at the current tier.

    Analytics dropdown open showing grouped reports

    Reports are grouped under the arrow. The reports available to you depend on your subscription, role, and permissions. See Drawing a report for how to use them.

    Reports at higher tiers take longer. A report on a single job takes seconds; a Tier 1 report on a very large dataset can take 2 to 3 minutes. A banner on the HUB turns green when the run is complete. Stay on the page while the report is running.

  9. Edit or delete actions are permission-gated.

    The Actions column on the Clients list and the edit controls on detail pages are available only to Administrator roles. This protects the tier data from accidental loss.

  10. Alternative entry: click a breadcrumb from the dashboard.

    Dashboard Job Results block showing breadcrumb lineage in the Developer/Region/Site column

    On the dashboard’s Job Results block, the Developer/Region/Site column shows the full breadcrumb for each job. Each segment is a link. Click any segment to jump straight to that tier’s detail page without going through the Clients list.


Tips


What next


Feedback

Was this page helpful?

Finding a job

You will know how to open the full Jobs list, read a row at a glance, and jump from the list to a single job or to any tier above it.

HUB v2.3+


Before you start


When to use the Jobs list

The Jobs list is the full, permission-scoped inventory of every job you can see. Use it when you want to browse or scan rather than look up a specific job.

For a single known job, the main search at the top of the HUB is faster. See Your dashboard for the main search.


Steps

  1. Click the cogwheel in the top bar, then Jobs.

    Cogwheel menu with Jobs and Clients grouped under Manage

    The Jobs page is the full list of jobs you have permission to see.

  2. Look at the Jobs list.

    Jobs list page, top half: header, task bar, and first rows

    Columns are:

    • Job — the job code and name (for example, AES2391 Collaton St Mary, Torbay).
    • CPN — Client Project Number, the developer’s own reference for the job (for example, HM-13115).
    • Plots — the number of plots on the job.
    • Developer / Region / Site — the full breadcrumb showing where the job sits in the Tier Structure.
    • Actions — edit and delete controls, gated to Administrator roles.

    The # chip on the left of each row is the Tier 5 marker, the Job-level equivalent of the Roman numerals (I, II, III, IV) you saw on the Clients list.

    Reading a job code. The letter prefix in front of the number identifies the energy-assessor firm that owns the job.

    • AES_nnnn_, a job by AES Sustainability Consultants (for example, AES2391).
    • AWE_nnnnn_, a job by Award Energy (for example, AWE10101). Award does not run its own numbering system, so these numbers are assigned automatically by the HUB.
    • FES_nnnnnn_, a job by The FES Group (for example, FES008429).
    • JSP_nnnnn_, a job by JSP Sustainability (for example, JSP20859).
  3. Use the task bar to refine the list.

    Jobs list task bar showing Status, Type, Search, and display count
    • Status filters jobs by lifecycle state (for example, created). Not fully implemented yet, you can ignore it for now.
    • Type filters jobs by category. Not fully implemented yet, you can ignore it for now.
    • Search filters the list by name, job code, or CPN.
    • Display count (30 / 90 / All) sets how many rows show per page. The Jobs list uses higher numbers than the Clients list (10 / 25 / All) because most users have far more jobs than clients.

    Note. The Search, display count, and pagination controls behave the same way on every list page in the HUB. See Understanding the Tier Structure for the reference walk-through.

  4. Scroll to the bottom of the list to reach pagination and the total count.

    Jobs list page, bottom half: last rows, pagination, and count indicator
    • Pagination sits centred below the table. Click a number or the arrows to step through pages.
    • Count indicator sits below pagination (for example, 1 to 30 of 190 jobs). It shows the current range and the total number of jobs in your permission scope.

    Tip. Do not flip through pagination page by page on a long list. Use Search, the display count, or the Tier Structure to narrow the view first.

  5. Click a job row to open that job’s detail page. The detail page covers everything attached to the job: reports, photos, BRELs, and more. See The job page.

  6. Click any segment of the breadcrumb in the Developer/Region/Site column to jump to that tier’s detail page.

    Each segment is a link. Clicking the Developer name opens that Developer page; clicking the Region name opens that Region page. This is the same breadcrumb behaviour as the dashboard Job Results block.

  7. Edit or delete actions are permission-gated.

    The Actions column is available only to Administrator roles. This protects the job data from accidental loss.


Tips


What next


Feedback

Was this page helpful?

The job page

You will know how to navigate a job’s detail page, read its key facts at a glance, find the right plot, and draw reports at job level.

HUB v2.3+


Before you start


When to use the job page

The job page is the single source of truth for a job. It shows where the job sits in the Tier Structure, who it belongs to, what it contains at plot level, and what reports can be drawn on it. Use the job page when you need plot-level files, Part L performance numbers, or any job-level report.


Steps

  1. Land on the job page.

    Job page folded, showing header, Back to Jobs and Analytics buttons, and collapsed Key Facts and Plot List blocks

    The top of the page shows:

    • Breadcrumb — the full tier lineage above the job. Each segment is a link. See Understanding the Tier Structure for how breadcrumbs behave.
    • Job name — the job code and full site name (for example, Job #AES7770 East Hill, Chatham).
    • CPN — Client Project Number, the developer’s own reference for the job (for example, HM-21974).
    • a.k.a. — the site’s primary alternative name. See Your dashboard for why alternative names exist and how they help with search.
    • Back to Jobs — returns to the full Jobs list.
    • Analytics — opens the job-level reports dropdown. See Drawing a report.

    Below the header sit two collapsible blocks: Key Facts and Plot List. They are unfolded by default when you land on the page. Click the + or next to a block name to fold or unfold it. Folding a block you are not using keeps the page tidy.

  2. Read the Key Facts block.

    Key Facts unfolded showing Building Type, Heating, Carbon, Fabric, Primary, SAP rating, and Avg SAP Rating

    Key Facts is an at-a-glance summary of the whole job.

    • Building Type — icons with counts for every building type present on the job. The example above shows Detached (26), Semi-Detached (62), Mid-terrace (1), End-Terrace (2). Only types present on the job are shown. Other types (for example, bungalows or flats) would appear only if the job contained plots of that type.

    • Heating — icons with counts for every main heating type present. The example shows Mains Gas (68) and Electricity (23). Same rule: only types present are shown.

    • Carbon (DERTER), Fabric (DFEETFEE), and Primary (DPERTPER), the three Part L performance KPIs, aggregated across the whole job. Each tile shows the designed value, the target value, and the percentage by which the job beats the target.

      Jobs assessed under Welsh or Scottish regulations show a different KPI set. The KPIs on these tiles always match the regulation that applies to the job.

    • SAP rating — a dynamic bar graph showing how plot SAP ratings are distributed across the job. The graph uses a finer gradation than the headline EPC bands (A to G), splitting the top bands into sub-ranges (A 101+, A 95 to 100, A 92 to 94, B 88 to 91, B 85 to 87, B 81 to 84) so differences between plots are easier to see. The graph extends downwards as lower bands are needed.

    • Avg SAP Rating — the average SAP EPC rating across the whole job. The example shows B 90.

  3. Use the Plot List block.

    Plot List unfolded showing task bar and plot table with pagination

    The Plot List is a row-per-plot table of every plot allocated to the job.

    Pagination and the count indicator sit centred below the table (for example, 1 to 20 of 91 plots).

    Task bar.

    Plot List task bar showing Stage, Block, Search, and display count
    • Stage — narrows the list by lifecycle stage. Values are explained below.
    • Block — shown only if the assessor has grouped plots into blocks, for example a block of apartments or a row of terraces. If no plots are grouped, the Block filter is not displayed.
    • Search — filters the list by plot number or text in the row.
    • Display count (20 / 50 / All), sets how many rows show per page.

    Stage values.

    Stage filter dropdown open showing All, Design, Prepare, Testing, As Built, and Completed
    • All — every plot, regardless of stage.
    • Design — plots at design stage. Design documents live here (Design SAP, Design PEA, Design BREL or Design BRWL, and related files).
    • Prepare — the interim stage between Design and As Built, used to capture changes (heating design changes, PV design changes, and so on) before an EPC is lodged.
    • Testing — plots with an air test certificate. Depending on your contract with the energy assessor, other commissioning certificates may be available here.
    • As Built — plots with every document required for an EPC. Typically the signed BREL or BRWL, the Photo Evidence report, and the As Built SAP.
    • Completed — plots flagged as complete. Completed is a manual trigger at plot level and also propagates automatically when the whole job is marked complete.

    Columns.

    Plot List close-up: column headers and first rows
    • Plot — the plot number. Click it to open the plot’s own page. See The plot page.
    • Stage — the plot’s current stage, inferred from the documents uploaded to it.
    • Block — populated only for plots that have been grouped into a block.
    • Files — the number of documents uploaded to the plot. Read it together with Stage. For example, Testing with 1 file means the air test certificate is uploaded. As Built with 3 files typically means the As Built SAP, the EPC, and the BREL are all in place.
    • Building Reg. — the building regulation under which the plot is assessed. Values are Part L 2009, Part L 2013, Part L 2021, and FHS (Future Homes Standard). Welsh and Scottish regulations are grouped under their English counterpart and appear here with the English label.
    • Actions — edit and delete controls, available only to Administrator roles.

Tips


What next


Feedback

Was this page helpful?

The plot page

You will know how to navigate a single plot, switch between the data captured at each stage, read its key facts and performance indicators, and open or download its files.

HUB v2.3+


Before you start


When to use the plot page

The plot page is the single source of truth for one plot. It shows the plot’s key facts and performance numbers at every stage captured for it, and gives access to every file uploaded against it. Use the plot page when you need plot-specific detail: air test results, uploaded documents, or the EPC certificate number.


Steps

  1. Land on the plot page.

    Plot page folded, showing header with navigation arrows, Back to Job button, stage pills, and collapsed Key Facts, KPIs, and File List

    The top of the page shows:

    • Breadcrumb — the parent job and the plot (for example, #AES7770 › ●001). The job segment is a link back to The job page. The before the plot number is decorative.
    • Plot header — the plot number followed by the stage currently being viewed (for example, Plot ●001 As Built).
    • Left / right arrows — step to the previous or next plot in the job, in plot-number order. Any filters you set on the parent job’s Plot List (Stage, Block, Search) are respected, so the arrows step only through plots that match those filters.
    • Back to Job — returns to the parent job page.
    • Stage pillsDesign, Prepare, Testing, As Built, Completed. Pills are colour-coded:
      • Red — the stage has data captured for it. Click the pill to switch to that stage’s data.
      • Purple — the stage is currently being viewed. This can be any stage with data, not just the most recent.
      • Grey — the stage has no data captured for it. Grey pills are not selectable.

      The stage pills are an interactive selector. Switching pill changes what shows in Key Facts, Key Performance Indicators, and File List. The plot header updates to name the stage you are viewing.

    Below the header sit three collapsible blocks: Key Facts, Key Performance Indicators, and File List. They are unfolded by default when you land on the page. Click the + or next to a block name to fold or unfold it.

  2. Read the Key Facts block.

    Key Facts unfolded showing Building Type, Heating, Carbon, Fabric, Primary, SAP rating, Air Pressure, and Solar tiles

    Key Facts is the plot-specific version of the job-page Key Facts. Every tile refers to this single plot at the currently selected stage.

    • Building Type, Heating, Carbon (DERTER), Fabric (DFEETFEE), Primary (DPERTPER), and SAP rating, as on The job page, but for one plot. Jobs assessed under Welsh or Scottish regulations show the matching KPI set here too.
    • Air Pressure — the air-tightness result for the plot.
      • Before a test has been uploaded, the tile shows the Design A/P target only.
      • Once an air test is uploaded, the tile expands to show Actual ▸ Design (the tested value against the design target).

      Failed air test. If the Actual value is higher than the Design target, the plot has failed the air test. A retest is typically done until the design target is met.

    • Solar — the plot’s installed solar capacity in kWp. This is an aggregated figure for the plot and does not break out individual arrays. For array-level detail, see the PV Pipeline Report (coming soon).
  3. Read the Key Performance Indicators block.

    Key Performance Indicators unfolded showing EPC Date, EPC number, No. Storeys, Building Regulations, Calculation Type, Address, Construction Type, and Ventilation System Type

    The KPI block is a grid of reference values for the plot at the selected stage. Which items populate depends on the stage: some items (for example, the EPC number and date) only appear once the plot is completed.

    • EPC Date — the date the EPC was lodged.
    • EPC — the EPC certificate number (for example, 7436-6434-0100-0453-1296). Enter this number on the government’s Find an energy certificate service to pull up the full certificate.
    • No. Storeys — the number of storeys in the plot.
    • Building Regulations — the regulation under which the plot is assessed (for example, SAP 2021). Welsh and Scottish regulations are grouped under their English counterpart.
    • Calculation Type — the SAP calculation mode (for example, NewBuildAsBuilt).
    • Address — the plot’s full postal address.
    • Construction Type — the main wall construction for the plot (for example, Cavity Wall).
    • Ventilation System Type — the main ventilation system (for example, Continuous Mechanical Extracts).
  4. Use the File List block.

    File List unfolded showing Type, Filename, Rev, and Actions columns for three files

    The File List shows every file uploaded against the plot at the selected stage. Columns are:

    • Type — the file’s category (for example, SAP PDF, EPC Report, BREL Report (signed)). The set of available types varies by stage. See File types (coming soon) for a walk-through of each type.
    • Filename — the full file name as uploaded.
    • Rev — the revision number. When a file has more than one revision, each revision is viewable in the preview overlay as its own tab.
    • Actions — a download button for the current revision.

    Accepted formats. The HUB accepts PDFs and common image formats (JPG, PNG) only. Nothing else can be uploaded.

    Click the file type to open the file in the File Preview overlay.

    File Preview overlay showing the Rev pill, Download and Close buttons, and an embedded PDF viewer

    The preview overlay shows:

    • Rev pill — marks the revision currently being viewed. If the file has multiple revisions, each is available as its own tab at the top of the overlay. Click a tab to flip to that revision.
    • Download — saves the currently viewed revision to your computer.
    • Close — returns you to the plot page.
    • Viewer — renders PDFs and image files natively. Standard PDF controls (page through, zoom, search, print) are available for PDF files.

Tips


What next


Feedback

Was this page helpful?

Drawing a report

You will know how to draw a report at any tier, how the HUB handles the run, and where filters come in.

HUB v2.3+


Before you start


When to use this page

Use this page when you need a report for a developer, a division, a region, a site, or a single job. The Analytics button and the reports behind it are the same on every tier detail page. Only two things change as you move down the tree: the scope of the report, and which reports appear in the dropdown.


Steps

  1. Open Analytics on the tier you want to report on.

    Navigate to the detail page for the developer, division, region, site, or job you want. See Understanding the Tier Structure for how to walk the tree, or The job page for the job detail page.

    Click the arrow next to Analytics to open the reports dropdown.

    Analytics dropdown open on a Tier 1 Developer page

    Which reports appear depends on three things combined:

    • Subscription — what your organisation has bought.
    • Role — what your role is allowed to do.
    • Permissions — which tier you sit on.

    A report listed for one user may not appear for another on the same tier.

    Data by Site is above-job-only. The Data by Site report lists every job beneath the current tier. It appears at Tiers 1 to 4 (Developer, Division, Region, Site) and is hidden at Tier 5 (Job), because a job already is the unit the report would return. The other reports are the same list at every tier.

  2. Pick a report.

    Click the report you want. The HUB opens a new page for that report with a Filter Settings panel on the left and an empty main pane showing Please set filters.

    Report page with Filter Settings panel on the left and an empty main pane labelled Please set filters

    The filter panel is tailored to the report. Common filter groups include Report type (Design / As Built / Hybrid), Part L Building Regulations, SAP Region, Lodgement Date Range, Client, Jobs, Building Connotation, and Main Construction.

    See Adjusting filters for what each filter does, the defaults, and how they combine.

  3. Apply the filters to run the report.

    At the bottom of the Filter Settings panel, click Apply. The HUB runs the report and the table paints in the main pane. Click Reset to clear the panel and start again.

    • Job level returns in seconds.
    • Region and Division are typically fast.
    • Developer level on a very large dataset (12,000 plots or more) can take 2 to 3 minutes.

    Stay on the page while the report is running. A banner on the HUB turns green when the run is complete. Do not use the browser’s Back button or navigate away until the table has painted.

  4. Work with the table, or export to Excel.

    Once the table is in the main pane you can scroll, sort, and interrogate it on screen. To take the same data out of the HUB, click XLSX at the top of the page to download an Excel copy.

    To leave the report, click Back at the top of the page to return to the tier you drew the report from.


Tips


What next


Feedback

Was this page helpful?

Adjusting filters

Every report in the HUB opens with a filter panel on the left. Nothing runs until you set your filters and click Apply. This page walks through the panel, the fourteen filter groups, and the buttons at the bottom.

All HUB versions


Before you start

The filter panel opens on the left of every report. The right-hand canvas shows a guidance prompt, “Please set filters”, reminding you the report is waiting for your selections.

Four rules apply across every filter group on this page. Learn them once and the rest reads easily.


When to use this

Every time you open a report at the Developer, Division, Region, or Site tier. The plot page is the only place in the HUB where a report can run without the filter panel.


Steps

  1. Open a report. Click a report from the Analytics dropdown on a tier page. The filter panel appears on the left. The right-hand canvas shows Please set filters until you apply. See Drawing a report for how to reach the panel.

  2. Check the defaults on landing. When you arrive on the panel:

    • Lodgement Date Range is set to EPC mode, last 3 months.
    • Part L Building Regulations has 2021 pre-selected (the current live regs).
    • If you launched from a job page, that job is already in Jobs. If you launched from a higher tier, the scope inherits from the breadcrumb.
    • Everything else is empty.

    The defaults are a sensible starting point for most jobs. Change whatever does not fit your question.

  3. Pick your filters. The fourteen filter groups below run top to bottom in the panel. Use the subsections as a reference, you only need the groups relevant to your question.

    ### Report type

    Three pills at the top of the panel, Design / As Built / Hybrid, controlling which plot stages feed the report.

    • Design — plots at Design and Prepare stages (modelled, pre-construction figures).
    • As Built — plots at Testing, As Built, and Completed stages (actual figures captured after construction).
    • Hybrid — both together, combining design-stage figures for plots that have not yet been built out with as-built figures for those that have.

    Default: Hybrid. Unlike the rest of the panel, Report type is single-select, clicking another pill replaces the current choice rather than adding to it.

    ### Part L Building Regulations

    Part L Building Regulations filter showing four pills (2010, 2013, 2021, FHS) with 2021 selected by default

    Four pills for the SAP methodology / building-regulations band:

    Pill SAP version England Wales Scotland
    2010 SAP 9.90 Part L 2010 n/a Section 6 (2010)
    2013 SAP 9.92 Part L 2013 Part L 2014 Section 6 (2015)
    2021 SAP 10.2 Part L 2021 Part L 2022 Section 6 (2022)
    FHS SAP 10.3 Part L 2026 TBC TBC

    Scottish and Welsh equivalents are rolled under the English year labels for simplicity. If you are looking for Wales’s 2014 regs or Scotland’s 2015 regs, both sit behind the 2013 pill.

    FHS is a placeholder for the Future Homes Standard. It lights up when the first FHS design data lands. See Key terms for the SAP 10.3 vs HEM distinction.

    Default: 2021 selected. Flip Select All for all four pills at once.

    ### SAP Region

    SAP Region filter showing three icons for England, Scotland, and Wales

    Three icons: England, Scotland, Wales. The HUB reads the region from the SAP (or future HEM) document.

    Default: nothing selected (all regions included).

    ### Lodgement Date Range

    Lodgement Date Range filter in EPC mode with pills 3, 6, 12, All, Custom

    One filter group with two modes, toggled EPC / CML.

    EPC mode filters by the date the EPC was lodged on the official register (gov.uk for England, Scottish EPC Register). If a certificate has been re-lodged (for example to fix an address), the latest date wins. EPC dates are always historic, the pills are 3 / 6 / 12 / All / Custom months back.

    Lodgement Date Range filter in CML mode with bidirectional pills -3, -6, -12, +3, +6, +12, All, Custom

    CML mode filters by Practical Completion date. A past CML means the plot is completed and handed over; a future CML is a target date, the basis of every pipeline report. The pills go both backwards and forwards: -3 / -6 / -12 / +3 / +6 / +12 / All / Custom. See Key terms for the full CML definition.

    CML data is entered by the housebuilder, not by AES or the energy assessor. AES does not control the timing or accuracy of these dates. For queries about missing or incorrect CMLs, contact your technical departments or portal admins.

    Using Custom. Click Custom to open a calendar picker. Click the start date, then the end date, or drag to select a range.

    Custom date range calendar picker showing the April 2026 calendar with a date highlighted

    Default: EPC mode, 3 months selected, the last 3 months of EPC lodgements.

    Design-stage plots have no EPC lodgement yet. If you are looking at design-stage data, leave the EPC pills unselected, otherwise the report will return zero results for design-stage plots.

    ### Client and Jobs

    Client and Jobs filter with two free-text fields and one job pre-loaded as a chip

    Two free-text fields with type-ahead search.

    • Client — search by developer name. If you serve more than one developer you can add several clients to combine them in one report.
    • Jobs — search by job code (AES2391) or site name (Collaton St Mary). Add as many as you need; the report combines them. You see only jobs for which you have permission on the tier tree.

    When you launch a report from a job page, that job is pre-loaded in Jobs. Remove it with the bin icon to broaden the scope, or add more jobs to combine them.

    Default: whatever the launch context pre-loads. Empty elsewhere.

    Competitive neutrality. Energy assessors serving multiple developers can combine their own clients here. Developers are confined to their own data and cannot add a rival developer. See Where your data lives.

    ### Building Connotation

    Building Connotation filter showing six built-form icons: Detached, Semi-detached, Mid-terrace, End-terrace, Bungalow, Apartment

    Six built-form icons, read from the Built Form field on the SAP document:

    • Detached
    • Semi-detached
    • Mid-terrace
    • End-terrace
    • Bungalow
    • Apartment

    Every plot in the HUB is classified under one of these six. The filter is exhaustive, even where the plot card shows a free-text variant.

    ### Main Construction Type

    Main Construction Type filter showing six material icons: Timber, Cavity, Solid, Steel, System, Curtain

    Six materials for the plot’s primary external wall. Read from the SAP document:

    • Timber — timber frame
    • Cavity — masonry cavity wall
    • Solid — solid wall (brick, block, stone)
    • Steel — steel frame
    • System — system build (SIPs, panelised)
    • Curtain — curtain walling

    ### Construction Type

    Construction Type filter showing the same six material icons as Main Construction Type

    Same six materials, but looking at every external wall on the plot, including the primary one. Useful when a plot has mixed walls and you want to catch it under any of its materials, not only the dominant one.

    Main vs Construction Type. Pick Timber in Main to find plots where timber is the primary wall. Pick Timber in Construction Type to find any plot with timber walls somewhere, primary or secondary.

    ### Heating Fuel

    Heating Fuel filter showing five fuel icons: Gas, Solid, Oil, Electricity, None

    Five fuel categories, read from the SAP Main Heating 1 field, or the communal heating fuel where a communal system is in place:

    • Gas
    • Solid — solid fuel (wood, biomass, coal)
    • Oil
    • Electricity — electricity feeding the main heating
    • None — no on-plot heating fuel at all (rare but possible)

    None is a genuine “no fuel”, not a communal plot. Communal systems still record the fuel powering the energy centre.

    Main Heating 2 (for example a log burner on top of a main boiler) and secondary heating are not read by this filter.

    ### Heating Type

    Heating Type filter showing four system icons: Boiler, Electric, Heat Pump, Other

    Four system-type buckets. Same source as Heating Fuel, the SAP main or communal heating:

    • Boiler — gas, oil, or solid-fuel boilers
    • Electric — direct electric heating (panel heaters, electric boilers, storage heaters)
    • Heat Pump — air-source, ground-source, water-source
    • Other — anything not in the three above

    The top three buckets cover the vast majority of plots. If Other is returning a lot of results, flag it, we can spin it into its own filter.

    ### Heating Emitter

    Heating Emitter filter showing four emitter icons: Radiators, Underfloor, Fan Coil Units, combined Rad and UFH

    Four emitter types for the plot’s main heating system:

    • Radiators — wall-mounted wet radiators
    • Underfloor — underfloor heating only
    • Fan Coil Units — fan-assisted emitters, typical with heat pumps
    • Rad. / UFH — both radiators and underfloor on the same plot

    Communal plots won’t match emitter filters. SAP does not record emitter data for communal heating systems. If you pick any emitter here, communal-heating plots are excluded from the result.

    ### Ventilation

    Ventilation filter showing six system-type icons: PIV, Intermittent, dMEV, cMEV, MVHR, Other

    Six ventilation system types:

    • PIV — Positive Input Ventilation (typically a loft-mounted fresh air fan)
    • Intermittent — intermittent extract fans in wet rooms
    • dMEV — Decentralised Mechanical Extract Ventilation (one continuous fan per wet room)
    • cMEV — Centralised Mechanical Extract Ventilation (single central fan, ducted)
    • MVHR — Mechanical Ventilation with Heat Recovery (supply and extract, recovers heat)
    • Other — anything not in the five above

    ### Renewables

    Renewables filter showing four icons: PV, SHW, WWHR, Battery

    Four on-plot renewable technologies. A plot can have any combination; the filter matches any of your picks (OR within the group):

    • PV — photovoltaic solar panels
    • SHW — Solar Hot Water (thermal)
    • WWHR — Waste Water Heat Recovery
    • Battery — battery storage

    Pick PV and Battery to find plots with either or both. To find plots with both at the same time, combine this group with a different narrowing filter elsewhere, or export to XLSX and cross-filter there.

  4. Apply or Reset. When your filters are set, use the two buttons at the foot of the panel:

    Apply and Reset buttons sitting at the foot of the filter panel
    • Apply — runs the report against your filters.
    • Reset — clears every filter, including the defaults (EPC + 3 months, Part L 2021). Use it for a clean slate.

    Reset is scorched-earth. If you Apply immediately after a Reset, the report runs against the full dataset in your permission tree. Expect a larger result and a longer run time. If you only want to change a few filters, edit them in place, don’t Reset.

  5. Review, amend, or export. The right-hand canvas changes based on what Apply returns.

    Before you Apply, the canvas shows a guidance prompt, “Please set filters”, reminding you the report is waiting for your selections. The XLSX button is greyed out. See the hero at the top of this page for the full view.

    Right-hand canvas after a filter run that returned no rows, showing the message 0 Plots

    If your filters are too narrow, the report runs but returns zero rows, the canvas shows 0 Plots. XLSX stays greyed out. Widen a filter (for example move the EPC pill from 3 to 12 months), click Apply again, and the report re-runs.

    When results come back, the table fills the canvas and XLSX activates. Review on screen, or download to Excel to interrogate further. See Drawing a report for the table and XLSX detail.


Tips


What next


Feedback

Was this page helpful?

Reports summary

This page is the entry point to the Reports section. It explains what a HUB report is, how every report is shaped, and which page to open for the detail on each one.

All HUB versions


What a HUB report is

A report is an Excel-style table that aggregates every plot beneath the tier you run it from, filtered by the choices you set in the filter panel. Reports are launched from the Analytics dropdown on any tier detail page. See Drawing a report for the launch mechanics and Adjusting filters for the panel that sits in front of every report.

Reports fall into two families:


How every plot-level report is shaped

Open any of the six plot-level reports side by side and you will see the same three-part structure.

Static front — identity. The first block is always the same core set of columns that tell you which plot and job the row belongs to. The core eight are always present:

Between Developer and the report-specific data sit the tier columns for whichever tiers exist in your developer’s tree: Division (T2), Region (T3), Site (T4). A small single-tier developer will see none of these. A large housebuilder with a full tree will see all three. In the worked examples used throughout this manual you will typically see Developer plus Division plus Region, three tier columns in addition to the core eight.

After the tier columns come three plot-descriptor columns, House Reference, House Type, and Connotation. These close out the static front. The total static front therefore runs from 11 columns (single-tier developer) to 14 columns (full Developer / Division / Region / Site tree).

Middle — report-specific. Every report carries its own payload here. Completions gives you the headline EPC and BREL performance numbers; Energy gives you the end-use energy breakdowns; M&E, PV, and Fabric give you the respective component detail; NextGen gives you the end-use intensity split. Some columns repeat across reports (for example, DER and TER appear in both Completions and NextGen) — those are documented once in Shared middle columns so each report page does not repeat the definition.

Static rear — two dates. Every plot-level report closes with the same two date columns:


Where to go next


What next


Feedback

Was this page helpful?

Getting help and giving feedback

This page tells you where to go if you hit a problem, how the AES support team handles a report, and where your data lives.

All HUB versions


If you hit a problem

Contact the AES support team by email or phone.

When you email, include as much as you can: the page you were on, the job number, what you were trying to do, and a screenshot if the problem is visual. It helps us work the issue faster.

What happens next. Every email and phone call is logged as a ticket in Zoho Desk, our helpdesk system. Zoho Desk assigns each ticket a number so you and the AES team can track status, history, and any follow-ups in one place. You will get an email confirmation with the ticket number when your request is logged.


How quickly we respond

Once we have the ticket we let you know how long we expect a fix to take. We aim to resolve most issues within one working day of the initial report. Saturday, Sunday, and UK public holidays do not count as working days.


Planned maintenance

The HUB runs two kinds of maintenance.


Supported browsers and devices

The HUB runs in a modern web browser on a laptop or desktop. There is nothing to install. The table below shows what we test against. Older browsers may work with reduced feature support.

Platform Minimum Recommended
Windows Chrome v96+ or a Chromium-based browser Chrome / Edge (latest stable)
macOS Safari v14+ or Chrome v96+ Safari / Chrome (latest stable)

Mobile apps are coming. The HUB is web-only for now. Native iPhone and Android apps will arrive in the App Store and Play Store in a future release.


Giving feedback on the manual

Every page in this manual ends with 👍 / 👎 buttons. The button opens a pre-filled email to the team. A thumbs-up tells us what landed well; a thumbs-down tells us what needs work. If your point does not fit a single page, email hubadmin@aessc.co.uk with “Manual feedback” in the subject.

We use feedback to decide what to write next. It is the fastest way to shape the manual.


Where your data lives


What personal data we hold

We hold the information tied to your user account: your name, job role, and email address. Optionally you can add a photograph, a mobile number, and a digital signature to enable digital BREL signing. All of this is encrypted on the same basis as the rest of your data.

We use it for two things only:

We do not use your personal data for marketing.

Who builds and runs the HUB. The HUB is developed and maintained by Burg Eins GmbH, AES’s software partner. Your personal data is shared with Burg Eins solely to run and maintain the HUB.


How long data is kept

All data is retained for 15 years following completion of the property the data relates to.


Asking for your data back

You can request a data extraction at any time. The service is free of charge within 12 months of the termination of your contract. After 12 months, a fee applies. Email hubadmin@aessc.co.uk with “Data extraction request” in the subject to start one.

For day-to-day data exports (a single report to Excel, for example), use the XLSX button inside a report. See Drawing a report.


What next


Feedback

Was this page helpful?

Data by Site

Data by Site is the only report that does not give you one row per plot. It gives you one row per job, sitting at any tier from Developer down to Site. It is the bird’s-eye view of the portfolio beneath wherever you are standing in the tree.

All HUB versions


When to use this

Data by Site is the overview dashboard for the tier you launch from, a one-row-per-job summary of everything happening underneath. Use it whenever you want to step back from the per-plot detail and answer planning-and-status questions:

Use a plot-level report instead when you want the technical detail behind those jobs.

A note on Percentage Completion. A job’s completion figure is driven by the EPC Lodgement Date. A plot only counts towards completion once its EPC has been uploaded. Two situations to watch for:

  • A job stuck at 99% for months when you expected it to wrap up, the most likely cause is one or more plots missing their EPC upload. Worth chasing the assessor.
  • A job reading 100% when the site is clearly only part-built, most often seen during the transition onto the HUB, when assessors first upload only their completed plots and have not yet caught up with the not-yet-finished design plots. The figure self-corrects once the full dataset is uploaded.

Data upload is the assessor’s responsibility, not AES’s. AES provides the platform; the assessors upload the data. If you spot incomplete uploads or missing sites, your first contact is your assessor. For technical issues with the platform itself, email hubadmin@aessc.co.uk.


Where Data by Site is available

Data by Site appears in the Analytics dropdown at Tiers 1 to 4: Developer, Division, Region, and Site. It is hidden at Tier 5 (Job) because a job is already a single Data by Site row, there is nothing to summarise. See Drawing a report for how to launch it from any tier.


What you see in the table

Twelve columns, one row per job under the tier you launched from.

# Column What it shows
1 Client Job-Nr. The developer’s own job reference (the CPN), e.g. HM-20996. This is the developer’s number, not the energy-assessor code.
2 Job-Name The descriptive name of the job (Sherford Phase 1a, Parcels 4 & 5).
3 Developer Tier 1.
4 Division Tier 2. Empty if the developer has no Division tier.
5 Region Tier 3. Empty if the developer has no Region tier.
6 Site Tier 4. Empty if the job is not grouped under a site.
7 Job Status Where the job sits in its lifecycle (e.g. In Progress, Completed).
8 Nr. of Plots How many plots the job covers.
9 Building Regulations The SAP / regs band of the job, e.g. SAP 2009, Part L 2021, FHS. See Adjusting filters for how the bands map to England, Wales, and Scotland.
10 Percentage Completion How far through the job is. Blank until plots have been processed.
11 EPC Lodgement Date The date for the job’s EPC lodgement reference, where applicable.
12 CML Date Practical Completion date, past for completed jobs, future for forecast targets. See Key terms.

There is no plot-level data on this report. To drill into the plots inside any of these jobs, click the job number in the Jobs list or run a plot-level report scoped to that job.


How the rows are aggregated for a developer

A developer running Data by Site sees every job in their portfolio beneath the tier they launched from, regardless of which energy assessor delivered it. If a developer has bought licences for several assessor firms (for example AES, AWE, FES, and JSP), Data by Site combines all four assessors’ jobs for that developer into one table.

The view stops at the developer’s own boundary. Another developer’s data never appears, even if both developers happen to use the same assessor firm. See Where your data lives for the full data-isolation model.


Tips


What next


Feedback

Was this page helpful?

Shared middle columns

Some plot-level reports share columns. To save reading the same definition five times, the cross-report columns are gathered here. Each per-report page links back when the column appears in its middle.

All HUB versions


How to read this page

Each column is described once with three things:

The descriptions below are enough to read the report. For the deep SAP / HEM derivation behind any column, contact the AES support team, see Getting help and giving feedback.


TFA, Total Floor Area

TFA is the denominator for any per-area metric (kWh/m², kgCO₂/m²/year). Used widely in the energy and EUI reports.


Actual vs notional building

Every SAP calculation runs in parallel for two buildings: the actual dwelling as designed and built, and a regulation-defined notional dwelling. The notional dwelling is the yardstick, the actual must beat it on each compliance metric for the dwelling to pass Building Regulations.

What is the same

The notional dwelling shares the actual dwelling’s shape, dimensions, and orientation: same floor area, same number of storeys, same window orientations, same site exposure. The geometry of the building is held constant, because changing it would defeat the comparison.

What is different

The notional dwelling uses standardised specifications set by the building regulations, not the choices the designer has made. SAP fixes these values across every dwelling so the target is consistent and the design freedom sits with the actual building. Examples for SAP 10.3:

  • Heating system — an air-source heat pump with a Seasonal Coefficient of Performance (SCOP) of 2.5 (or the equivalent for communal heat networks).
  • Ventilation — dMEV with a specific fan power of 0.15 W/(l/s).
  • Air permeability — 4 m³/h·m² at 50 Pa.
  • U-values — a regulation-fixed set for walls, roofs, floors, windows, and doors.
  • Solar PV — propagated through from the actual dwelling, capped (for houses, at 40% of gross floor area divided by 4.5).

The actual dwelling carries the real values, the wall constructions chosen, the heating system installed, the windows specified, the air permeability achieved on test.

How it drives the D / T pairs

Every output prefixed D (Dwelling) is calculated for the actual building. Every output prefixed T (Target) is calculated for the notional building. The pass criterion across the three Building Regulations lenses:

Lens Actual (Dwelling) Target (Notional) Pass when
Carbon emissions DER TER DER ≤ TER
Primary energy DPER TPER DPER ≤ TPER
Fabric energy efficiency DFEE TFEE DFEE ≤ TFEE

The %-impr. columns on the Completions Report (DER TER %-impr., DPER TPER %-impr., DFEE TFEE %-impr.) show the margin by which each lens passes, positive means a pass with that margin.


Performance summary cluster (Completions + NextGen EUI)

These six columns are the headline EPC and air-test numbers that appear at the top of the Completions Report and again as a summary block on the NextGen EUI Report.

DER, Dwelling Emission Rate

  • What it is — the calculated CO₂ emissions for the dwelling per square metre per year.
  • Unit — kgCO₂/m²/year, rounded to 2 decimal places.

TER, Target Emission Rate

  • What it is — the regulatory CO₂ target for the dwelling per square metre per year. Pass criterion is DER ≤ TER.
  • Unit — kgCO₂/m²/year, rounded to 2 decimal places.

AAP, Actual Air Pressure

  • What it is — the measured air-permeability after construction, taken from the on-site air-tightness test.
  • Unit — m³/h·m² @ 50 Pa, rounded to 2 decimal places.
  • AAP is the as-built measurement that pairs with DAP (Design Air Pressure) on the Completions Report. Pass criterion: AAP ≤ DAP. If measured exceeds design, the air test has failed and a re-test is normally arranged. See The plot page for how AAP and DAP appear on the plot card; DAP itself is documented on the Completions Report page.

SAP Rating

  • What it is — the headline A to G rating shown on the EPC, with the underlying SAP score (0 to 100+).
  • Unit — none, displayed as a number followed by the letter band (e.g. 87 B).

PV kWh

  • What it is — the annual electricity generated by the on-plot PV system.
  • Unit — kWh/year. Displays zero or blank when the plot has no PV.

PV kWp

  • What it is — the installed peak capacity of the on-plot PV system (the headline manufacturer rating).
  • Unit — kWp, rounded to 3 decimal places. Displays zero or blank when the plot has no PV.

Main Heating System 1 and 2 (M&E Pipeline + NextGen EUI)

The HUB models up to two main heating systems per plot. MHS1 is the primary system. MHS2 is the secondary system on plots that have one, typically a log burner or similar alongside a primary boiler or heat pump. Each system carries the same four-column block.

How the values reach the report

In SAP, the assessor enters heating system data using one of three modes:

  • From database (PCDB) — the product is registered in the PCDB. Manufacturer, Model, Type, and all performance values pull automatically. The assessor cannot change any performance data.
  • Manufacturer — the product is not in the PCDB. The assessor enters Manufacturer, Model, and all performance values freely.
  • SAP Table — the product is not in the PCDB. Performance comes from generic SAP tables and cannot be edited by the assessor; Manufacturer and Model can still be entered manually.

So Manufacturer and Model populate automatically for PCDB entries, and from the assessor’s manual input for SAP Table or Manufacturer entries. They stay blank when the product is not in the PCDB and the assessor has not filled them in. Fuel is always populated regardless of mode.

The same logic applies to MHS2 and to the Secondary Heating System (SHS). For SHS, manual entry is the norm, the typical SHS products (log burners, gas fires) are not registered on the PCDB.

Fuel

  • What it is — the fuel powering the heating system (Gas, Oil, Solid, Electricity, etc.). Always populated.

Type

  • What it is — the system type (Boiler, Heat Pump, Storage Heaters, Warm Air, Micro CHP, Underfloor, Range Cooker Boiler, Room Heaters).
  • For PCDB entries, Type comes from the PCDB section of the product. For SAP Table or Manufacturer entries, Type comes from the SAP file’s classification.

Manufacturer

  • What it is — the manufacturer name (Vaillant, Worcester Bosch, Mitsubishi, etc.). Pulled from the PCDB for registered products; from the assessor’s manual SAP entry otherwise; blank if neither.

Model

  • What it is — the specific model name. Same source rules as Manufacturer.

The same four columns repeat for MHS2 with the prefix changed.


Energy DER PV (Energy Report + PV Pipeline)


What next


Feedback

Was this page helpful?

Completions Report

The Completions Report is the per-plot record of every plot’s headline performance figures, lodgement details, and pass/fail metrics against Part L. One row per plot.

All HUB versions


When to use this

The Completions Report is designed and optimised for completed plots, it gives you the headline overview most often needed for reporting, audit, and handover. It pulls together each plot’s as-built EPC data, air-test results, and pass margins against the regulatory targets in one row.

The report is not restricted to completed plots, it works for any plot, but the columns it carries are most meaningful once a plot has been lodged on the EPC register and air-tested.

Typical questions it answers:


Structure


Address and location

The plot’s full lodgement address. Three columns:

These appear on the EPC certificate when the plot is lodged on the register.


Building information

Four columns describing the dwelling and its compliance band.


Performance summary (Completions-only)

The remaining nine columns are the calculated performance numbers Completions exposes on top of the shared cluster. They are grouped by what they tell you.

Air pressure (1 col):

Heat-loss parameter (1 col):

Carbon emissions — DER vs TER comparison (3 cols):

Primary energy — DPER vs TPER comparison (3 cols):

Fabric energy efficiency (3 cols):

DFEE / TFEE are how the dwelling’s fabric (walls, roof, windows, floors) is judged on its own merits, separate from the heating system’s contribution.


Tips


What next


Feedback

Was this page helpful?

Energy Report

The Energy Report breaks down each plot’s end-use energy figures across heating, hot water, lighting, pumps and fans, cooling, and PV, for both DER (the actual dwelling) and TER (the notional / regulatory yardstick). See Actual vs notional building on the Shared middle columns page for what DER and TER actually mean. One row per plot.

All HUB versions


When to use this

Use the Energy Report when you need to see where the energy goes in a dwelling, broken down by end use. The report is used at two points in a plot’s lifecycle:

Typical questions it answers:

It is the natural companion to the M&E Pipeline Report and the PV Pipeline Report, they describe the systems, this one tells you what the systems are using in modelled energy terms.


Structure

A small reading note: the header kWh/m² appears more than once in this report. Each instance is the per-area version of the column immediately before it. The header will become more specific in a future release.


Why each end-use figure appears twice

Space heating and hot water demand are reported in two places on this report, once as the actual demand of the dwelling (before any system losses), and again inside the DER and TER blocks as the delivered energy (after the heating system’s losses are applied). Both figures matter for different reasons.

The actual demand is what the dwelling fabric and the occupants ask for: the heat the building needs to keep warm, the hot water the household consumes. It is independent of the heating system. The delivered figure is what the heating system has to put in to meet that demand, accounting for how efficiently the system converts fuel or electricity into heat.

A worked example for a 5,000 kWh actual space-heating demand:

Showing both numbers makes the underlying demand directly comparable across heating systems, while the DER and TER figures show what each system has to deliver.


Actual energy demand, before losses (4 cols)

The first block is the dwelling’s actual demand, before any heating-system losses.

These two end uses are the largest contributors to a typical dwelling’s demand and are reported first.


DER components, after losses (10 cols)

The middle block is the DER (Dwelling Emission Rate) breakdown, the modelled delivered energy by source, after each system’s efficiency losses are applied.

Space heating sub-totals (3 cols):

These three sum into the dwelling’s total space-heating demand.

End-use components (5 cols):

Totals (2 cols):


TER components, after losses, target (9 cols)

The third block mirrors the DER block but with the regulatory target figures (the notional dwelling). Same after-losses framing as DER. One fewer column because there is no MHS2 row at the TER side.

Space heating sub-totals (2 cols):

End-use components (5 cols):

Totals (2 cols):


Tips


What next


Feedback

Was this page helpful?

M&E Pipeline Report

The M&E Pipeline Report is the mechanical and electrical detail behind every plot, heating systems, hot water, ventilation, showers, and waste-water heat recovery. One row per plot.

All HUB versions


When to use this

Use the M&E Report when you need to know what is installed in the dwelling, not just how much energy it uses. The report can be used heavily across two scenarios:

Typical questions it answers:


Structure


Main Heating System 1, extra detail (5 cols)

After the shared MHS1 block, the M&E report adds the controls and emitter detail.


Hot water and cylinder (9 cols)

Everything about how the dwelling makes and stores hot water.


Main Heating System 2, extra detail

The MHS2 four-column block (Fuel / Type / Manufacturer / Model) is in Shared middle columns. M&E does not add MHS2-specific detail beyond that.


Communal and cooling (2 cols)


Ventilation (5 cols)

Manufacturer and System Name follow the same source rules as MHS1. PCDB-registered units pull automatically; non-PCDB units rely on the assessor’s manual entry in SAP, otherwise the cells stay blank. See the MHS1 section in Shared middle columns for the three SAP entry modes.


Showers and waste-water heat recovery (10 cols)

Part L 2021 only. Showers and WWHR are captured for Part L 2021 plots. Earlier regs (2009/2013) do not populate these columns.

The HUB models up to three showers per plot. Each shower carries the same three-column block:

Three sets of Shower Type / Description / Flow rate (showers 1, 2, 3) make up nine columns. The tenth is:


Tips


What next


Feedback

Was this page helpful?

PV Pipeline Report

The PV Pipeline Report is the per-plot detail of every photovoltaic installation, array specs, energy contribution, and install attributes. One row per plot.

All HUB versions


When to use this

Use the PV Pipeline Report when you need to know what solar is installed or planned on each plot. The report can be used heavily across two scenarios:

Typical questions it answers:


Structure


PV Type (1 col)


PV Array detail (5 cols per array)

The HUB carries one array block per array installed on the plot. A plot with one array has just one block; a plot with two has two blocks; the report scales as needed. Each array block carries the same five-column set:

For multi-array plots, each subsequent block (* 2, * 3, …) repeats with the same five attributes for that array’s specs.


Energy contribution (3 cols)

The PV report adds two PV-specific energy columns alongside the shared Energy DER PV total.

The two split out the headline generation: Used + Exported = Energy DER PV.


Install attributes (5 cols)

The remaining columns describe the metering and tariff setup.


Tips


What next


Feedback

Was this page helpful?

Fabric Pipeline Report

The Fabric Pipeline Report is the per-plot detail of every external and internal building element, walls, roofs, floors, party elements, windows, and doors. It is typically the largest report in the HUB by column count. The exact number of columns and elements varies per export, since the report carries as many instances of each element as the SAP file holds. One row per plot.

All HUB versions


When to use this

Use the Fabric Pipeline Report when you need to know what materials make up the dwelling envelope, for procurement, material take-offs, and design verification. The report can be used heavily across two scenarios:

Read the m² figures with two caveats in mind. SAP measures dimensions on the inside of the dwelling, so element areas can undercount external corners and overcount internal corners. SAP also only assesses the heated envelope, there is no data on the cold roof above a plane ceiling, no roof tile counts, no garage walls, nothing outside the warm shell. For materials sitting outside the heated envelope, take-offs must come from the architect’s drawings, not from this report.

Typical questions it answers:


Structure


How a Fabric grouping works

Every fabric element follows the same pattern: each element type can have multiple instances per plot, and each instance carries the same fixed set of attributes. The instance count varies by element (most plots will not use every available slot).

For example, a plot with three different external wall constructions will populate External Wall 1, External Wall 2, and External Wall 3, each with the same attribute set, and leave External Wall 4 blank.

The attribute set

Most elements share a common attribute set:

  • Description — a human-readable name for this instance, e.g. Cavity wall, render finish.
  • Type — the SAP element type or category.
  • Construction — a description of the build-up, layer by layer.
  • U-value — the thermal transmittance in W/m²·K. Lower is better.
  • Kappa — the heat capacity (thermal mass), in kJ/m²·K.
  • Gross Area — the total area in m².

Some elements add extra attributes:

  • External Wall also carries Net Area (gross minus openings) and Factor Code (a SAP shelter / orientation factor). The current report shows this column header as Nett Area; the spelling will be corrected in a future release.
  • External Roof also carries Shelter Factor Code.
  • Windows and Roof Windows / Lights have no Construction or Kappa, but add Data Source, Glazing, Solar Transmittance, and Frame Factor.
  • Solid Doors and Half-glazed Doors carry only Description, U-value, and Gross Area.

The element groupings

The Fabric report covers the categories of building element listed below. The number of instances of each element is set by the SAP file, if a plot has six external wall constructions, you will see External Wall 1 through External Wall 6, each with the full attribute set; if it has one, the others sit blank. The total column count therefore varies plot to plot and report to report.

Element Attributes per instance
External Wall Description, Type, Construction, U-value, Kappa, Gross Area, Net Area, Factor Code
External Roof Description, Type, Construction, U-value, Kappa, Gross Area, Shelter Factor Code
External Floor Description, Type, Construction, U-value, Kappa, Gross Area, Shelter Factor Code
Internal Wall Description, Type, Construction, Kappa, Gross Area
Party Wall Description, Type, Construction, U-value, Kappa, Gross Area
Internal Ceiling Description, Construction, Kappa, Gross Area
Internal Floor Description, Construction, Kappa, Gross Area
Party Floor Description, Construction, Kappa, Gross Area
Party Ceiling Description, Construction, Kappa, Gross Area
Window Description, Data Source, Glazing, U-value, Solar Transmittance, Frame Factor, Gross Area
Roof Window Description, Data Source, Glazing, U-value, Solar Transmittance, Frame Factor, Gross Area
Roof Light Description, Data Source, Glazing, U-value, Solar Transmittance, Frame Factor, Gross Area
Solid Door Description, U-value, Gross Area
Half-glazed Door Description, U-value, Gross Area

Walls, roofs, floors, and windows carry the most variation because a plot will commonly have several distinct constructions of each (for example, a typical house often has three external wall types depending on which face, and several windows in different rooms). Doors are simpler.


Tips


What next


Feedback

Was this page helpful?

NextGen EUI Report

The NextGen EUI Report is a per-plot Energy Use Intensity breakdown, the modern end-use analysis showing regulated energy and total EUI alongside the headline performance numbers. One row per plot.

All HUB versions


When to use this

Use the NextGen EUI Report for analytics and benchmarking, when you want a single, clean view of each plot’s Energy Use Intensity (EUI) and the end-use breakdown that sits behind it. Typical questions it answers:

NextGen sits one step beyond Energy: it expresses energy as intensity per area and adds regulated vs total context.


Regulated vs unregulated energy

The HUB pulls all regulated energy values directly from SAP, that is heating, hot water, lighting, pumps and fans, and cooling. Regulated energy is everything that Building Regulations consider when calculating compliance.

Unregulated energy is everything else the household consumes, white goods, plug-in appliances, cookers, IT equipment, EV charging in some scenarios. Building Regulations do not test or limit unregulated energy, but it forms a significant part of a dwelling’s true Energy Use Intensity. The HUB calculates the unregulated component using established external methodologies:

When the unregulated portion is missing, the Total Energy column shows the suffix “(Incomplete)”. The cause is almost always that the developer has not yet supplied the fit-out specification, what white goods will be installed, what plug-load assumptions apply, etc. Once that information lands, the suffix drops and the total becomes the dwelling’s complete EUI.


Structure


Design context (4 cols)

NextGen leads its middle with two design-context columns sitting just before the descriptor block, plus the EI Rating sibling to SAP Rating, plus a SAP-internal box reference.


Ventilation (4 cols)

NextGen reports the ventilation system the same way as M&E, plus the fan count.


End-use energy intensity (5 cols)

This is where NextGen earns its name, the dwelling’s end-use energy by category, in kWh/year terms feeding the EUI total.

The order matches the SAP design output, so you can read the NextGen end-use block alongside a SAP printout in the same sequence.


Totals and EUI (3 cols)

The closing block of the unique middle is the totals.


Tips


What next


Feedback

Was this page helpful?

User roles

A role is a named bundle of permissions that defines what a user can see and do in the HUB. The cogwheel menu is a small example: an analyst sees Jobs and Clients, while an admin sees Users and Roles in addition. Every user is given one or more roles when their account is created. Roles are predefined, AES owns the master list, and customers can request new ones or refinements at any time.

This page covers how to find the role list, what the columns mean, and who can change roles.

All HUB versions


Before you start


Open the Roles list

  1. Click the cogwheel in the top bar.

    Cogwheel Manage menu open with Jobs, Clients, Users, Roles

    The Manage menu opens with four entries: Jobs, Clients, Users, Roles.

  2. Click Roles.

    Roles list page with Global members button, Status filter, Search box, and two roles shown

    The Roles list opens. Each row is one role.


What you see

Note. What you see on this page is itself shaped by your role. An admin without role-management permission sees only the list. An admin with full role-management permission also sees + Role, Edit, Duplicate, and Delete. The page is the worked example of role-driven visibility.


How roles are managed

Note. Permissions are about what a user can do. They sit alongside the where dimension covered in Understanding the Tier Structure. A user’s effective access is the intersection of the two.


Tips


What next


Feedback

Was this page helpful?

Users

The Users page is the master list of every person who has access to your HUB. It sits below User Groups on the same User Management screen, and is where accounts are created, edited, invited, deactivated, and reactivated. It is also the canonical place to see where a single user is assigned: each user’s detail page lists every role and scope attached to them. The complementary view, where users are listed under a tier, is covered in Understanding the Tier Structure and User assignments.

This page covers how to find the User List, what the columns mean, the four statuses a user can hold, and how to create, edit, deactivate, and reactivate accounts.

All HUB versions


Before you start


Open the User List

  1. Click the cogwheel in the top bar.

    Cogwheel Manage menu open with Jobs, Clients, Users, Roles

    The Manage menu opens. Click Users.

  2. The User Management page opens. Scroll past User Groups at the top to reach the User List section.

    User List section showing Status and Group filters, Search, + User button, display options, and rows of users with their group, status, and actions

    Each section can be collapsed by clicking the small next to its heading.


What you see


User statuses and actions

A user moves through up to four states in their lifetime on the HUB. The Actions column shifts to match.

Status Meaning Action shown
Created Account exists in the HUB but no invitation has been sent. The user cannot sign in yet. Send Invite
Invited Invitation email sent, awaiting first sign-in. Resend Invite
Active User has signed in at least once and is using the HUB. Deactivate
Deactivated Account is locked, the user cannot sign in. The record stays in the list. Reactivate

Note. Users are never deleted. A user may have uploaded photos in SiteView or FireView, signed BREL paperwork, or carry historical notifications. Deactivation locks the account without losing any of that history. If access is needed again, click Reactivate and the user’s prior assignments resume.


Create a new user

Provided your role grants the create-users permission, click + User at the top of the User List to open the Add New User form.

Add New User form with Name, Surname, E-mail required, User Group dropdown and phone fields optional, plus a banner stating that the user is not informed by e-mail automatically

Fill in the form:

Click Create Account to save, or Cancel to discard.

Important. Creating an account does not send an invitation email. The new user lands on the User List with status Created. To actually invite them, find the row and click Send Invite in the Actions column. This two-step design lets you stage several accounts and invite them in a controlled wave.


Edit a user

Click a user’s name on the User List, or Edit in the Actions column, to open the user detail page.

User detail page for AES HUB Portal Admin showing Name, Surname, E-mail, Initials, User group, phone fields, and an Assigned Roles section

The detail page shows every field on the user record:

To change anything, click the Edit button at the top of the page. Make your changes and click Save changes, or Cancel to discard.

The Back to user management button returns you to the User Management screen.


See where a user is assigned

The user detail page is the canonical place to see all of a user’s assignments. Scroll to the Assigned Roles section at the bottom of the page.

Each row is one assignment, showing:

A user with multiple assignments shows multiple rows. The user’s effective permissions on any tier are the union of every role that applies to that scope.

Note. Assignments are read-only on this page. To add, edit, or remove an assignment, go to User assignments. The User account view is the user-up perspective (where is this user assigned). The tier views (cogwheel → Clients, then drill down) give the tier-down perspective (which users sit under this tier).


How user accounts are managed


Tips


What next


Feedback

Was this page helpful?

User groups

A user group is a coloured tag that bundles users together so they can be referred to as one. Groups are not permission containers, they are an organisational convenience: it is far easier to assign a role to one group of fifteen housebuilder users than to fifteen users one by one. Each user belongs to exactly one group or is ungrouped. Permissions stack via roles, not groups. See User assignments for how groups, users, and roles tie together at a tier.

This page covers how to find the User Groups list, what the columns mean, and how groups are created, edited, and joined.

All HUB versions


Before you start


Open the User Groups list

  1. Click the cogwheel in the top bar.

    Cogwheel Manage menu open with Jobs, Clients, Users, Roles

    The Manage menu opens. Click Users.

  2. The User Management page opens with two collapsible sections: User Groups at the top and User List below.

    User Management page with the User Groups section above the User List section

    Each section can be collapsed by clicking the small next to its heading.


What you see

Note. A user inherits their group’s colour on the User List below. That is why every chip on a user row carries the colour of the group the user belongs to. Initials on a user chip are the user’s own initials, not the group’s.


Open a group’s detail page

Click a group name on the User Groups list to open its detail page.

Group detail page for Housebuilder Admin Users, showing the group colour hex and the User List filtered to that group

The detail page shows:


Create a new group

Provided your role grants the create-groups permission, click + Group at the top of the User Groups list to open the New User Group form. If you do not see the + Group button, your role does not allow group creation.

New User Group form with empty Name and Colour fields, plus Cancel and Create group buttons

Fill in the two required fields:

Click Create group to save, or Cancel to discard. The new group appears immediately on the User Groups list.


Edit an existing group

Provided your role grants the edit-groups permission, click Edit on a group row to open the group’s edit form. If the Actions column is empty for that row, your role does not allow group editing.

Edit form for the HUB Admin group, with Name and Colour fields pre-filled, plus Cancel and Save changes buttons

The form is the same shape as the create form, with the existing values pre-filled:

Click Save changes to commit, or Cancel to discard.


How users join a group

Group membership is set on the user record, not on the group itself.

  1. Open the user card from the User List and click Edit.
  2. On the user form, find the User group dropdown.
  3. Pick a group, or pick ungrouped to leave the user out of any group.
  4. Click Save changes.

The user immediately picks up the new group’s colour on the User List.


How groups are managed

Note. Groups themselves do not carry permissions. Permissions live on user roles, and roles are tied to users (and groups) via user assignments.


Tips


What next


Feedback

Was this page helpful?

User assignments

A user assignment ties three things together: who (a user, or a group of users), what they can do (a role), and where they can do it (the scope, which is global or any tier from a Developer down to a single Job). Assignments are the place all of these come to rest. Almost every “who can see what” question on the HUB is answered here.

This page covers the assignment concept, the three entry points where assignments are managed, the universal +Assignment modal, the inheritance rules behind the Source column, and how to remove an assignment.

All HUB versions


Before you start


The shape of an assignment

Every assignment is a triple:

Effective access for a user on a tier is the union of every assignment that applies. Multiple roles overlap and stack, which is exactly the flexibility the system is designed to give.


Where assignments are made

Three entry points, all using the same +Assignment modal and the same list shape. Pick the one that matches the scope of access you want to grant.

1. Global

Open the Roles list (cogwheel → Roles), then click Global members at the top.

Roles list with the Global members button at the top

The page that opens is called Persons in charge.

Persons in charge: the global members list with breadcrumb Roles › Global members, a + Assignment button, and one member row showing source = global

Anyone assigned here gains the assigned role across every Tier 1 the customer holds. Use it for portal admins and any role that should follow the user wherever they go in the tree.

2. Any tier

Open the tier detail page (cogwheel → Clients, then drill in until you land on the Developer, Division, Region, or Site you need; see Understanding the Tier Structure for the navigation pattern). Click Members in the header.

Tier 1 detail page for Taylor Wimpey with Back to clients, Members, and Analytics buttons

The page that opens is called Permission management (prefixed with the tier name).

Taylor Wimpey Permission management with a + Assignment button and rows showing both direct assignments (source = Taylor Wimpey, with Delete) and inherited rows (source = global, no Delete)

Anyone assigned here gains the role at this tier and everything below it. Use it for divisional directors at Tier 2, regional directors / admins / analysts at Tier 3, site-level admins at Tier 4, and any role that should be scoped to one branch of the tree.

Important. Assignments are removed where they were created. To remove a row whose Source is global, you must go to the global Persons in charge page and delete it there. To remove a row whose Source is a tier name (e.g. Taylor Wimpey), click the link in the Source column to navigate to that tier and delete from there. The same rule applies at every scope: delete on a job page only removes assignments made at that job.

3. A single job

Open the job page and click Members in the header.

Job page header for #AES7770 East Hill, Chatham with Back to Jobs, Members, and Analytics buttons

Same name as the tier-level screen, just scoped to one job.

Job-level Permission Management for East Hill, Chatham, all rows inherited from Tier 1 or global

Use it for technical managers, site managers, and any role that needs access to one job only.


Add an assignment

The + Assignment button on any of the three screens opens the same three-step modal.

Assign a single person (or several)

Assign Person(s) modal in Single person mode, showing two selected users and one role
  1. Step 1, Select type. Click Single person.
  2. Step 2, Select person(s). Start typing a name. Pick a user from the dropdown. They appear as a chip below the field. Repeat to add more users to the same assignment.
  3. Step 3, Select role. Start typing a role name and pick one from the dropdown. One role per assignment. To grant the same people a second role, run the modal again.
  4. Click Assign to commit, or Cancel to discard.

Note. If a person you expect to find does not appear in the typeahead, they may not have accepted their HUB invitation yet. Check the Users list and click Resend Invite if their status is still Invited.

Assign a whole group (or several)

Assign Person(s) modal in Group mode, showing two selected groups and one role
  1. Step 1, Select type. Click Group.
  2. Step 2, Select user group(s). Start typing a group name. Pick a group from the dropdown. Repeat to add more groups.
  3. Step 3, Select role. Pick the single role.
  4. Click Assign.

Important. Group membership is captured at the moment you assign. If a new user is added to that group later, they do not automatically inherit existing assignments. Re-run the +Assignment flow when you onboard a user who needs to step into existing group access.


What you see on a permissions list

The list shape is the same across global, tier, and job views.

The bottom of the list shows pagination and a counter (11 to 16 of 16 members).


Source and inheritance

Inheritance flows downward through the tree:

Delete only ever sits on the row at the scope of origin. To remove an inherited row, click the link in Source to navigate to where it was made.


Remove an assignment

Click Delete on the row to unassign. The user (or group) loses the role at this scope and every scope below that inherited from it.

There is no in-place edit. To change a role, delete the existing assignment and create a fresh one with the new role.

Note. Removing a group assignment does not delete the underlying user records or the group itself. It only severs the role link at this scope.


Worked roles by scope

The same +Assignment mechanic supports very different operational profiles. A few examples to anchor the concept:

The flexibility comes from layering: a regional analyst with one Tier 3 assignment can be lifted to a divisional analyst with a Tier 2 assignment without anyone touching the Tier 3 record.


Tips


What next


Feedback

Was this page helpful?

File types

A plot moves through up to four upload stages on the HUB, Design, Prepare, Testing, and As Built, and each stage carries a specific set of documents. This page lists every file type, what it is, and when it appears. The mechanics of viewing, downloading, and revisioning files sit on The plot page; this page is the reference.

Files matter because the HUB does two jobs with them:

Coming soon: File sharing and BREL signing, which close the loop on why the uploads are worth doing.

All HUB versions


Before you start


The four stages at a glance

The Stage pills on the plot page switch the File List between four canonical sets. The voluntary entries are italicised.

Design Prepare Testing As Built
Design SAP PDF As Built SAP PDF (reduced) Air Test Certificate As Built SAP PDF
Design SAP PEA As Built SAP XML (reduced) MCS Certificate As Built BR(W)EL (signed)
Design SAP BR(W)EL As Built SAP XML
Design SAP XML EPC
Block compliance PDF Photo Evidence Report
Block compliance PDF

Note. BR(W)EL is one document with regional naming. England calls it BREL (Building Regulations England Lodgement). Wales calls it BRWL (Building Regulations Wales Lodgement). Scotland has no equivalent and nothing is uploaded for Scottish plots in this slot.


Design stage

The pre-construction snapshot. Documents are produced by the energy assessor from the property’s design specification.

Design stage File List for Plot 001 with SAP XML, SAP PDF, PEA Report, and BREL Report

Prepare stage

The voluntary in-between stage. AES uses Prepare to capture changes that have come in after the design issue but before the plot is genuinely As Built and ready for EPC lodgement. Typical examples: late address confirmations, revised heating designs, late-arriving PV designs.

Prepare stage File List for Plot 001 with two files, SAP XML and SAP PDF

The aim is to head off surprises on the day before CML, especially when changes shift KPIs in the wrong direction or threaten compliance.

Note. No new PEA or BREL is needed at Prepare. Those are issued at Design and re-issued at As Built.


Testing stage

Compliance evidence from on-site testing. The plot is built but not yet lodged.

Testing stage File List for Plot 001 with Air Test Certificate and MCS Certificate

As Built stage

The final, lodgement-ready set. This is what the plot looks like once construction is complete and the energy assessment has been signed off.

As Built stage File List for Plot 001 with SAP XML, SAP PDF, EPC, BREL Report (signed), and PE Report

Block compliance

A Block compliance PDF is the floor-area-weighted compliance calculation for a building that contains more than one dwelling, for example a block of flats or a terrace. Instead of demonstrating compliance plot by plot, the average target rates are calculated across the dwellings using a floor-area weighting.

The document is not mandatory and is not always needed. Upload it where it improves the audit trail.

The HUB has a useful side effect when one is uploaded: it creates a Block and groups the affected plots together. After upload, the Block filter at the top of the Plot List becomes a quick way to see all plots that share a compliance grouping. Only one upload is needed per block, attached to one of the affected plots.


Cross-cutting notes


Tips


What next


Feedback

Was this page helpful?