FAQ - Digital Carbon Online

Frequently Asked Questions

Installation

Basic installation

Once you’ve joined Digital Carbon Online, you’ll receive two emails. The first email “ Your Digital Carbon Online user details” contains the code snippets you need to install on your website.

The code snippet in your email will be pre-configured with your unique authentication code already inserted.

Copy and paste the entire code snippet from your email (from <script to </script>) into your website’s footer.

Note: Please make sure you replace <<Your Unique Authentication Code>> in the example with your actual code in the email.

Installing on WordPress? Check out our WordPress installation instructions here.

Verifying correct installation

Once installed, load your page and check the browser console for the message below.

If the code snippet has been installed correctly, you should see a message like “Enhanced privacy mode. Removing query strong”. Any other message, or no message at all could mean the script was not installed correctly. Please contact technical support for assistance.

Example code snippet
<script type="text/javascript" src="https://www.webco2.io/wti.webco2.3-min.js">
</script> <script type="text/javascript"> wti_webco2.init(["<<Your Unique Authentication Code>>"]); </script>
Correct installation

Once installed, use your browser’s console to check for this message. If you don’t know how to check your console, consult this article for guidance.

Failed installation

Advanced installation

In certain situations you might want to delay the loading of the javascript. This might be to optimise page load speeds.

Delaying the loading of script files is typically done using the ‘ defer‘ attribute. However this can lead to unpredictability if not done correctly.

In this example we’ve used the ‘ defer‘ attribute in both script tags, but have also identified the library using an id ‘ theScript‘.

We use this identifier to create a listener that executes the init function once the library is fully loaded.

Other approaches might work better for your set up, so please ensure you check correct installation as mentioned above.

Example delayed/Deferred loading
<!-- this might be inserted in the <head> -->
<script defer id="theScript" type="text/javascript" src="https://www.webco2.io/wti.webco2.3-min.js"></script>

<!-- other html in your page -->

<!-- this could be inserted in the <footer> -->
<script defer type="text/javascript">
  theScript.addEventListener('load', function () {
    wti_webco2.init(["<<Your Unique Authentication Code>>"]);
  });
</script>

Activating your badge

Digital Carbon Online provides badges that can be used to display your web page emission statistics on every page.

Example Digital Carbon Online Badge

The page shows the estimated emissions for the page it is presented on according to our dual methodology, along with the website’s average and how it compares to all other websites.

This badge can be activated on one or many pages.

To activate it you need to:

  1. Create a placeholder <div> and give it an id.
  2. Modify the init function call, to include the <div> id.
  3. By default the badge will include a link to your public dashboard. This can be disabled by specifying another parameter dash:false

Important: Badges require version 3 or higher of the wti.webco2.js script (wti.webco2.3-min.js) as shown in the example. When upgrading make sure you remove any previous references to earlier version and empty any caches.

Please contact technical support if you are unsure how to upgrade your installation

Customising the badge colours

It is important to include class="dco-badge <<style-variation>>" in your <div> (as shown in the examples).

This enables you to choose from different variations of colour scheme to suit your website.

The following style variations are available:

class="dco-badge solid-brand"

class="dco-badge solid-eco"

class="dco-badge transparent-dark"

class="dco-badge transparent-light"

Example installation with badge

The example below shows how to activate and place the badge.

<!-- load the script -->
<script type="text/javascript" src="https://www.webco2.io/wti.webco2.3-min.js"></script>

<!-- specify a placeholder for the badge -->
<div id="badge-goes-here" class="dco-badge solid-brand"></div>

<!-- other html in your page -->

<script type="text/javascript">
wti_webco2.init(
     ["<<Your Unique Authentication Code>>"],
      { target_div: 'badge-goes-here' }
); </script>
</script>

Disable public dashboard link

Example showing how to disable the public dashboard link with dash:false.

<!-- load the script -->
<script type="text/javascript" src="https://www.webco2.io/wti.webco2.3-min.js"></script>

<!-- specify a placeholder for the badge -->
<div id="badge-goes-here" class="dco-badge solid-brand"></div>

<!-- other html in your page -->

<script type="text/javascript">
wti_webco2.init(
     ["<<Your Unique Authentication Code>>"],
      { target_div: 'badge-goes-here', dash:false  }
); </script>
</script>

Data

What data do we collect?

The only information sent to the Digital Carbon Online server are the URLs of visited web pages.

The server keeps a tally of how many times each unique URL is visited.

We keep data for unto 12 months, then it is deleted.

Data Security

Data security is paramount.

By default, any parameters that appear in the web page URL are discarded before the URL is sent to the server. This ensures no sensitive data is included in the process.

Information is sent to the Digital Carbon Online server using industry standard secure HTTPS connections.

To ensure privacy and protection of private data, only publicly accessible pages are analysed.

Access to our databases is controlled by strong password encryption.

Clients have access to bespoke dashboards to explore and download their data. Access to these dashboards is via WordPress and protected by named accounts and industry standard strong password requirements.

WordPress is protected using industry leading firewall technologies. WordPress administrator accounts are further protected with multi-factor authentication.

More details about our security practices are available on request.

Reporting

When should I be able to see my data?

Assuming the code snippets have been correctly installed, data will be sent to our database every time a page is loaded/visited.

The data will not immediately appear in your private or public dashboards.

The data presented in your dashboards is summaries and aggregates data for monthly reporting, and is processed according to certain schedules and intervals.

It is not possible to determine the precise timing of the schedules since it is dependent on when the UK’s energy grid is at its lowest carbon intensity. More information can be found about this in our blog article here.

As described in that article, if the energy network has not achieved a low carbon intensity for a few weeks, we will process the data anyway to ensure you have access to the reports and data on a monthly basis.

Your first month

When you first register and install the code in your website, we are happy to provide confirmation that data is being received. Simply email support [at] digitalcarbononline.co.uk with your domain name and unique authorisation code.

Since the reporting is monthly, your first reports will be available after one full month of operation.

Methodology

The basics

Once installed on a website, Digital Carbon Online receives ‘pings’ from the site containing the URL of the page that was viewed. By default, any query parameters on the URL are removed before it is sent to Digital Carbon Online.

We collate the ‘pings’ over time, and at certain points in time assess the carbon footprint of each page using both of our methodologies.

The exact timing of when we assess the pages depends on the UK energy grid’s carbon intensity, see here for more info.

Time-shifting

Our service runs on a green-host and our office operates on its own micro-grid, utilising solar power where possible, and recharging batteries from a renewable energy supplies when not.

To further reduce the carbon impact of the Digital Carbon Online service, we adopt a time-shifted approach to assessing the carbon footprints of each page, this acknowledges that even though our service runs on renewables, the sites we test and the infrastructure they depend on might not.

We align our processing with the carbon intensity of the UK’s National Grid, opting for times when the grid is either “low” or “very-low”. To ensure our monthly data summaries are updated on time, we delay processing for up to a month but as we approach this limit, we increase our carbon intensity tolerance one step at a time.

While this approach has been taken to primarily minimise the carbon overhead of our operations, it is acknowledge that this might introduce a slight bias into the results. However, given the Green Web Foundations’ SWDM model relies on historic global energy and traffic data, the impact on the results is expected to be within existing uncertainty bounds.

Read more about our design decisions, here.

Re-testing

Web page carbon emissions vary over time. As such, Digital Carbon Online will reassess each and every page over a period of time. By default the time between retesting 60 days ±10 days.

The 60 day timeframe has been chosen to provide a balance between frequency to capture variations in page size and unnecessary carbon overhead. Additional variation of ±10 days is introduced to avoid overloading websites.

Users may request a full or partial recalculation at any point – within sensible limits – if, for example, they have recently completed significant work.

We keep a history of page weights over time, ensuring when we calculate historic summaries we use the weight that was valid for that time.

Green hosts

Digital Carbon Online utilises the Green Web Foundations’ Green Host data set to determine if the host we are testing is considered ‘green’ (likely to run on renewable energy) or not.

“Weighing” pages

Digital Carbon Online leverages the nascent webpage carbon calculation standard as being defined by the Green Web Foundation.

The process of determining the carbon dioxide emissions of a web page is a complex affair that is based on the energy required to transfer data, and involves assumptions about where energy is used during the transmission of data required to deliver a web page. The methodology defined by the Green Web Foundation, splits these assumptions across energy used by the end user device, the networks and the server.

Fundamentally, the Green Web Foundation’s methodology relies on understanding the size (in bytes) of a web page.

Digital Carbon Online takes two approaches to determining the page size; one approach (“standard”) follows the same approach as other online website carbon calculators, which relies on the use of Google PageSpeed to identify the byte-size of the pages. The other (“alternate”) methodology takes a different, potentially more realistic approach to determining the byte-size of the pages under test, attempting to include deferred and “lazy loaded” content. .

Both data points are captured, used and presented within Digital Carbon Online to help users understand that the true CO2 weight of a page isn’t a single number, but a range.

These two approaches are designated in the Digital Carbon Online dashboards as the “ Standard Model” and the “ Alt Model“. Which of these is ‘better’ or ‘worse’ really depends on how the website has been built, so it will vary from site to site.

Statistical analysis of the two models indicate correlation, as expected. Both a Spearmen and Pearson analysis broadly agree, with Pearson indicating a moderate-strong correlation. (Pearson ≈ 0.71)

Note: if you’ve requested one of our Free Reports, this uses the Standard Model only.

Pearson/Spearmen correlation: Moderate-strong with outliers .

Future-proofing

Website are continuously updated and refreshed, so too are the techniques and standards used to build them. Similarly, the best practice for assessing website carbon footprints evolves.

In this regard, Digital Carbon Online’s approach is to be a fast-follower of the nascent standards, thereby giving industry changes time to mature before impacting our users.

Migrating to SWDM v4

Click here to learn about our approach to migrating to a major update of the underlying assessment methodology.

Additional information on our methodology and limitation can be found here.

Marketing claims

We highly recommend user seek independent legal counsel before making any claims using data from Digital Carbon Online or the Digital Carbon Verified® logo. See our guidelines for more information.

Subscription management

To upgrade, manage or cancel subscriptions please contact us via the Contact Us page, including your domain name and the email address associated with your account.