Welcome to the repository of the Web Sustainability Guidelines (WSG).
If you would like to learn more about us and how to participate in this project, please check the readme in the W3C Sustainable Web Interest Group repository.
The chartered focus of the W3C Sustainable Web Interest Group is the development of the Web Sustainability Guidelines (WSG) and its deliverables.
Links to relevant documents (based on the CG Draft Report) can be found below.
Guidelines:
| Name | Status | Date |
|---|---|---|
| Web Sustainability Guidelines (WSG) | W3C Editors Draft | 17 Feb 2025 |
Other Deliverables:
| Name | Status | Date |
|---|---|---|
| Sustainable Tooling And Reporting (STAR) | W3C Editors Draft | 17 Feb 2025 |
| WSG At A Glance | W3C Editors Draft | 14 Feb 2025 |
| Introduction to Web Sustainability | W3C Editors Draft | 10 Feb 2025 |
| Web Sustainability Laws & Policies | W3C Editors Draft | 12 Feb 2025 |
| Quick Reference for WSG & Checklist (PDF) | W3C Editors Draft | 17 Feb 2025 |
| WSG JSON API | JSON API | 17 Feb 2025 |
| STAR JSON API | JSON API | 19 Feb 2025 |
| STAR Test Suite | Test Suite | 17 Feb 2025 |
| Name | Date |
|---|---|
| Initial Draft | 30 June 2025 |
| Final Draft | 31 December 2025 |
| Measurability | 31 Mar 2026 |
| W3C Draft Note | 22 Apr 2026 (Earth Day) |
Note: We will still consider the remaining proposed and planned updates carried forward from the Sustainable Web Community Group (based on both W3C and CG member feedback).
Work is planned in accordance with the issues requiring resolution.
If you would like to contribute towards this specification, please refer to the CONTRIBUTING.md document for details and refer to the guidance on the W3C Sustainable Web Interest Group repository readme regarding participation.
We have two JSON APIs which are kept in sync with the changes occurring within our specification and STAR.
These documents are reachable via GitHub pages and can be queried using JavaScript to embed our data within your client of choice.
WSG (guidelines.json)
category[1].guidelines[0].guideline = "Undertake Systemic Impacts Mapping"
STAR (star.json)
category[1].techniques[0].title = "Produce a List of Variables To Monitor for Sustainability Impacts"
Note: To match a WSG guideline to a STAR technique, you can match the guideline testable anchor hash (WSG JSON API) to the technique id (STAR JSON API).
We have a Test Suite which is used to showcase machine testability (as denoted in STAR) for the Web Sustainability Guidelines (WSGs). The template structure for the file uses common W3C conventions for test cases to maintain interoperability for tooling that wishes to align our work with their own.
Key concepts of note include:
Below are some handy links for contributors to our project: