User Guide

Instructions on how to get the most out of the software


The guide below provides instructions to help you get the most out of the Ecologic energy assessment and retrofit platform. The first three sections 'Audit your property', 'Assess your options' and 'Act on your plan' provide instructions for the core functionality for all users. The Professional Features section provides guidance for how to use features specific to energy service professionals, and the Partner Features section provides more detailed instructions on configuring the platform for utilities, cities and other channel partners.

    Audit your property

    The following instructions detail how to input the information required to perform an energy audit.

      Answering audit questions

      The Audit Process comprises a series of Questions, with a form control provided depending on the type of data being provided.

      Some common form controls include:

      • Option Buttons, which allows a single selection to be defined from a set of choices, for instance, what type of building you have
      • Checkboxes, which allow multiple selections to be defined from a set of choices, for instance, what sorts of insulation you have installed
      • Ranges, which allow a number to be defined between two range extents by dragging a handle,
      • Spinners, which allow a number to be defined arbitrarily, either by clicking in the text field and typing or by clicking the plus or minus buttons either side of the field,

      There are also several special controls that are unique to the Ecologic software:

      • the Building Control, which allows the building geometry, zoning, and shading to be specified on an aerial photograph (see 'Describing your building')
      • the Multiset Control, which allows large numbers of similar appliances to be defined, for instance, collections of televisions or fridges (see below)

      Questions are grouped into Sections, with each Section representing a particular building feature, fixture or appliance. Sections are turn grouped into Steps, which represent collections of similar Sections such as those sections on utilities, the building occupants, electronic appliances etc.

      the Multiset Control

        Adding more detail

        Instead of overwhelming you with questions, we've gone with a more layered approach. Questions are grouped by priority, with critical questions such as the type of heating system shown prominently, and more detailed questions shown in optional slide-out forms. If you'd like to add more detail about a property feature by, for instance, adjusting the thermostat setting of your heating system, simply click 'more detail' and the additional questions slide out from below the top-level question.

          How defaults work

          If you don't want to answer a question that's no problem. We fill any unanswered questions with smart defaults.

          The defaulting logic varies from question to question and is detailed in the Engineering Reference Documentation however the following provides some simple examples:

          • if the building or appliance is old, it is likely to have poorer performance
          • if a building is occupied throughout the day, they are more likely to use appliances, lighting and HVAC equipment during the day
          • if a building is large, then they are likely to have more appliances and lighting fixtures

          Many defaults are location-specific, such as the local electricity tariff structure and rates, or the most common heating or cooling system.

          The default is typically shown in the audit interface as a greyed question.

            Getting more information

            If you're unsure how to answer a question or if you'd like to learn a bit more about a particular question, click the 'more info' button in the bottom right of the question card. This will launch a dialogue box which will explain why the question is important, and provide further detail on each of the question options.

              Describing your building

              The audit requests a range of details about your building to assess how it is likely to perform throughout the year and how much energy your heating and cooling systems are likely to use. This includes:

              • the building type
              • the building age
              • the wall details (wall type, eave depth etc)
              • the window details (glazing type, frame type, coverings etc)
              • foundation details
              • roof details

              In addition, the audit includes a widget to describe the specific geometry and features of the building. To specify the building geometry:

              1. Firstly, you will need to specify the exterior boundary of the building (or the boundary of the dwelling or premise if a multi-tenant building). To do this click on one of the corners of the building and then continue in a circuit around each of the corners of the building , and then continue the circuit until you return to the first corner, which will close the polygon.
              2. If you wish to divide the building into component zones (for instance, if the building has heaters and/or coolers serving parts of the building), you'll want to create an internal wall or partition. Click 'add' and then click on the wall you wish to divide, then click any internal zone vertices and finish the divider by placing a final vertex on another existing wall (internal or external).
              3. Once you have finished creating walls, you can edit walls by clicking on a wall or edit zones by clicking anywhere within the zone.

              Generally your answers to the wall questions above will be applied as defaults to all walls you have specified in the wall widget, however if you wish to specify an exception for a specific wall or walls, you need to edit that wall. Simply click on an existing wall to edit, which will show a dialogue box, with a set of questions for that wall (e.g. wall type, window area, external boundary condition, eave depth etc).

              the Map control

              Assessing your options

              Once the simulation have been completed you will be sent a list of charts to help you analyse your energy use and help you develop a tailored energy plan.

              The first page provides a sense of how the property performs, including a comparison of the energy consumption with typical and efficient properties, and a breakdown of which appliances consume the most energy and money to run.

              the Audit Results Page

              The second page provides information to help you identify your tailored energy plan. This includes the estimated cost of each action, together with the bill savings likely to be achieved, taking into consideration your unique conditions.

              You can add or remove actions from your plan by clicking on the action cards. Once you're happy with your selection click 'act on my plan' to pledge your actions and create your plan.

              the Assess Page

                Acting on your plan

                We have provided a range of services to help you implement your tailored energy action plan.

                When you click 'Act' on the top navigation menu you are taken to the Plan section. Here you are presented with a card for each of the items you nominated earlier.

                For tailored advice and product offers click the relevant action.

                To request a specific offer, click 'Get Quote' and fill out the form fields provided. This will forward your contact details and product specifications to your preferred product or service provider.

                the Plan Page

                  Professional features

                  This section provides instructions on how to perform several features that are unique to Ecologic Pro and Ecologic Partner

                    Managing multiple audits

                    To create an additional audit

                    1. Navigate to the dashboard by clicking the 'Dashboard' link on the top menu or by clicking the logo
                    2. Click the plus button to the right of the address dropdown to create a new audit
                    3. If you are a member of multiple teams, you will need to select which team to create the audit under

                    To review your list of audits

                    1. Navigate to the dashboard as above and click the 'list' icon to the right of the 'plus' button
                    2. You will be sent to a new page with a list of all your audits
                    3. You can edit the audit data, review results, edit the action plan, and generate reports using the buttons to the right of each listed audit
                    4. You can also export a CSV report of your audits by clicking the link at the top of the screen

                    the Dashboard Page for Ecologic Pro

                      Managing your team

                      To edit your team:

                      1. navigate to the team console by clicking 'Account' in the top navigation menu and then selecting your team
                      2. click 'Members' in the side navigation menu

                      To add a team member:

                      1. firstly make sure the team member has created an account using the user sign up form, ensuring they sign up using the email address option (not using social auth)
                      2. navigate to the team console (see above)
                      3. click 'Add member' within the member admin page (see above)
                      4. provide the email address that the user signed up using
                      5. specify the access level that you intend for the user, for a rough guide, members can only access and review the audits they have created or those that have been assigned to them, managers can access and review all audits across the team, and admins, can add and remove team members

                      To remove a team member or change their access level:

                      1. firstly ensure you are logged in using a team account with the 'admin' access level
                      2. navigate to the team console (see above)
                      3. click the relevant team member
                      4. click remove member or change their access level in the dropdown and click update

                        Generating reports

                        To generate a report

                        1. Navigate to the Dashboard by clicking the 'Dashboard' link at the top of the screen or by clicking the logo
                        2. Activate the relevant audit using the property dropdown
                        3. Click the PDF icon next to the audit review button

                        To edit the report logo, standard text copy or styling:

                        1. Navigate to your Team Admin console by clicking 'Account' and then clicking your team from the dropdown menu
                        2. On the 'Team Profile' tab click 'Edit report'
                        3. Edit the relevant content using the form fields and click 'Update'

                        Partner features

                        This section provides instructions on how to perform several features that are unique to Ecologic Partner

                          Managing your gateway

                          Your Ecologic Partner subscription includes a Gateway or white-labelled instance of the Ecologic Platform for your networks to self assess their properties.

                          Your Gateway includes the ability to provide the following customisations:

                          • a custom logo for the app and reports
                          • a vanity URL (e.g.
                          • custom css styling for the app and reports including background color, feature colour etc
                          • custom copy for the automatically generated reports
                          • custom email templates for notifications
                          • configurable notifications for quote requests, either an email address or webhook address

                          To edit your gateway:

                          1. Firstly ensure you are logged into your team account and that your user has Admin privileges (see the section above to edit user privileges)
                          2. click 'Account' and then click your Team under 'Teams'
                          3. click 'Edit Team' on the 'Team Profile' tab
                          4. edit the relevant content using the form provided

                            Managing suppliers

                            Ecologic Partner provides support to manage a team of suppliers that are unique to your campaign.

                            To specify a set of suppliers within Ecologic you will need several key details:

                            • Supplier name
                            • Supplier logo
                            • Either an email address or a webhook address for receiving automated quote requests

                            For each specific offer you will need to provide:

                            • Product / service name
                            • Feature image and up to 3 other product images (ideally large and high resolution)
                            • Product summary (short paragraph hook shown 'above the fold' describing product / service)
                            • Product description (~3 paragraphs detailed description of product / service)
                            • Price or (ideally) pricing business rules e.g. if ceiling insulation, $ / m2 ceiling area plus $ fixed fee, if solar, $ for different capacities, adjustments for multi storey, roof materials etc

                              Email campaigns

                              Ecologic Partner provides several features to support effective email marketing campaigns.

                              For campaign tracking purposes, Ecologic allows recruited participants to be tracked against a unique email campaign ID.

                              To streamline the experience for recruited participants, Ecologic provides support for key user details, such as name and email address to be included in a 'magic link'. Essentially, the user's details are embedded in an encrypted key, which is included in the email hyperlink. When the user clicks this link, their details will be forwarded to our database and an account automatically generated for them. To enable this feature you will need to obtain an encryption key from Ecologic Apps and we will assist you with creating the 'magic links'.

                                Social media campaigns

                                Your Ecologic Partner subscription includes several features to help you better support social media campaigns.

                                For recruitment tracking and improvement purposes, Ecologic supports the use of embedded campaign IDs for each campaign. This does not require any configuration within Ecologic, however it is important to embed the ID in the shared hyperlink.