A proposed convention for website owners and digital service providers to demonstrate that their digital infrastructure runs on green electricity. This is achieved by reusing existing governance structures, already published data, and existing industry standards as much possible.
Note: This project is currently in its very early stages. We are currently conducting a closed pilot to flesh out the specification, and identify use cases. If you would like to contribute or have questions, please open a GitHub issue or contact us by email.
Having a convention around how website owners and service providers disclose information about the energy they use allows for two things:
In order to achieve this, we believe that any proposed convention should:
We need a fossil free internet by 2030. But right now there's still not much transparency around how we source power.
To address this, Green Web Foundation has been building a Green Domains database, open sources the code for tracking this and is publishing open datasets about the state of the green web. Creating this dataset has been an ongoing effort for years. It has involved associating IP address space like IP ranges or Autonomous System Numbers with specific organisations, then manually verifying written reports and certificates provided by said organisations to back up their green claims.
This has worked for the first few million domains, and first few billion checks against the database. But the internet is a much bigger, more dynamic place than it was when this endeavour was started. Our approach needs to evolve with the times.
Luckily, today there are more tools that can help. Tools like the Domain Name System (DNS). DNS provides a variety of ways to establish a link between a domain and the party that is hosting or operating it. There are also dedicated registries that make it possible to trust that electricity has been generated from clean and renewable energy sources. And, if you know where to look, it's possible to tell when efforts to decarbonise energy are credible.
Carbon.txt serves to make links between these systems easier to follow. So when there is a claim that a website is running on green energy, you can trace the provenance of supporting evidence more easily.
If you provide hosted digital services to others, carbon.txt lets you:
Note: The carbon.txt specification is currently being trialled with digital service providers only. If you self-host, or have your own website, please see the FAQ for more information.
Register with Green Web Foundation
As a digital service provider, you should first register with The Green Web Foundation, and provide evidence of your green claims.
Create a carbon.txt file for your organisation
Create a carbon.txt file for your organisation. There is a guide to the expected syntax below.
Note: You only need one carbon.txt file for your organisation.
To link multiple domains to a single organisation, refer to the linking green claims to multiple domains section below.
Upload your carbon.txt file to your servers
For example: https://www.my-org.com/carbon.txt
We default to checking for a file located at the root of your domain /carbon.txt
.
Share the URL of the carbon.txt file with Green Web Foundation
The Green Web Foundation has an API for registering where to check for carbon.txt file for a given domain. Once this is listed, and the link established, your site shows as green.
You can complete this step on our website.
(Optional) Link other domains to your green claims if they are using infrastructure you control
If you offer managed hosted services to other organisations, once your first link is established there is an automated process for listing future domains so they show up as green too, with attribution to you. See domain hashes below for more.
The carbon.txt syntax is written in TOML. An example of what a carbon.txt file might look like for a digital service provider.
[upstream]
providers = [
# An array of providers my-org.com is using to deliver our service
{ domain='cloud.google.com', service = 'shared-hosting' },
{ domain='aws.amazon.com', service = 'cdn' }
]
[org]
credentials = [
# Optional.
# An array of documents that point to evidence of green claims made by my-org.com.
{ domain='my-org.com', doctype = 'webpage', url = 'https://my-org.com/our-climate-record'}
]
An example of a carbon.txt file for a digital service provider.
A list of accepted upstream provider services can be found on this FAQ page.
If there's a particular service you'd like listed, but which isn't on that page then please contribute to this issue.
It's fairly common that a digital service provider might own and provide services through multiple domains. They might also have multiple products, or provide hosted services for a number of users all who have their own domains.
In this case, you can maintain a single carbon.txt file at one domain (e.g. https://my-org.com/carbon.txt) and refer other domains to that single source of truth.
There are two supported ways to do this:
Using DNS TXT records is intended for organisations who are able to add DNS records to both their own domain, as well as the domain they want to show up as green. If you own both domains, this option is for you.
Guide: How to link multiple domains using DNS TXT records
Using a HTTP Via Header is intended for organisations who are not able to add DNS records for the domain they want to show up as green, but do accept HTTP requests for the domain, and serve responses for it. If you operate a CDN, a managed Wordpress service, or a general Platform-As-A-Service (PaaS) offering, this is usually better suited for your use case.
This option also allows you to "pass down" green claims to customer who use your service.
Guide: How to link multiple domains using HTTP VIA HEADER
Read the FAQ, or raise an issue.