Skip to content

Commit 021d052

Browse files
jorydotcomsaihaj
andauthored
Add Blog post announcing spec cut (#2120)
* Add Blog post announcing spec cut * fix lint --------- Co-authored-by: Saihajpreet Singh <[email protected]>
1 parent 6096caa commit 021d052

File tree

1 file changed

+61
-0
lines changed

1 file changed

+61
-0
lines changed
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: "Announcing the September 2025 Edition of the GraphQL Specification"
3+
tags: ["spec"]
4+
date: 2025-09-08
5+
byline: Lee Byron
6+
---
7+
8+
It’s here: the[ September 2025 edition of the GraphQL specification](https://spec.graphql.org/September2025/)!
9+
10+
This is the first edition of the specification since[ October 2021](https://spec.graphql.org/October2021/), and it reflects years of steady, collaborative work from the GraphQL community. More than 100 commits, hundreds of comments, and contributions from dozens of community members went into this update — all with the goal of keeping GraphQL stable, expressive, and primed for the next generation of AI-ready API development.
11+
12+
Since its initial release 10 years ago, GraphQL has grown into a critical layer of infrastructure at startups, enterprises, and platforms across industries. The spec has two guiding priorities:
13+
14+
**Stability first**: With so many tools and services built on GraphQL, the ecosystem relies on a solid foundation. This release fixes inconsistencies, addresses edge cases, and helps avoid performance pitfalls. \
15+
\
16+
**Expressiveness for API consumers**: Developers use GraphQL because it’s intuitive, flexible, and powerful. This edition makes the language even more productive and expressive, particularly for AI-first applications.
17+
18+
## **Why It Matters**
19+
20+
Several updates in this edition make GraphQL an even better foundation for AI assistants, codegen tools, and autonomous agents:
21+
22+
- Descriptions on executable documents give LLMs richer context for intent understanding and safer refactoring.
23+
- Schema Coordinates provide a precise, both human- and machine-readable way to reference fields and types, improving traceability, evals, and automated PR feedback.
24+
- OneOf input objects simplify schema entrypoints whilst maintaining type safety by expressing mutually exclusive inputs directly in the schema. This is particularly helpful for prompt and form generation.
25+
- The clarified execution/error terminology and request `extensions` make responses more predictable for deterministic parsers and toolchains.
26+
27+
## **Notable Updates**
28+
29+
- **OneOf Input Objects (a.k.a. input unions)** \
30+
A long-requested feature! This unlocks more natural ways to model mutually exclusive inputs, leading to tidier schemas and unlocking use-cases that couldn’t be safely expressed previously - check out the [blog post](https://graphql.org/blog/2025-09-04-multioption-inputs-with-oneof/).[ RFC #825 \
31+
](https://github.com/graphql/graphql-spec/pull/825)
32+
- **Schema Coordinates** \
33+
A standardized way to refer to parts of a schema, paving the way for better tooling, error reporting, and developer experience.[ RFC #794 \
34+
](https://github.com/graphql/graphql-spec/pull/794)
35+
- **Descriptions on Documents** \
36+
Improved support for documenting queries and operations — helpful for humans and increasingly relevant for AI-powered tools.[ RFC #1170 \
37+
](https://github.com/graphql/graphql-spec/pull/1170)
38+
- **Expanded Deprecation Support** \
39+
Deprecation is now more broadly supported across schema elements, making it easier to evolve APIs without breaking clients. [RFCs [#805](https://github.com/graphql/graphql-spec/pull/805), [#1040](https://github.com/graphql/graphql-spec/pull/1040), [#1053](https://github.com/graphql/graphql-spec/pull/1053), [#1142](https://github.com/graphql/graphql-spec/pull/1142)]
40+
41+
- **Full Unicode Support** \
42+
\*\*The language grammar now supports the entire Unicode range, improving internationalization and accessibility.[ RFC #849 \
43+
](https://github.com/graphql/graphql-spec/pull/849)
44+
- **Editorial Improvements** \
45+
The spec is clearer, more consistent, and easier to contribute to. Ambiguities have been reduced, and the style guide has been modernized.
46+
47+
## **Thank you, contributors!**
48+
49+
This edition wouldn’t exist without the dedication of the GraphQL community. Dozens of contributors — from core maintainers to first-time spec authors — invested their time and expertise to make GraphQL better for everyone.
50+
51+
Special thanks to the many reviewers, implementers, and champions who shaped this release.
52+
53+
You can explore the full list of contributors in the[ changelog](https://github.com/graphql/graphql-spec/blob/main/changelogs/September2025.md).
54+
55+
## **Get involved**
56+
57+
GraphQL is a living standard. If you’re building APIs, tooling, or clients, your voice matters in shaping its future. Anyone can join[ working group meetings](https://github.com/graphql/graphql-wg) and contribute proposals, reviews, or feedback.
58+
59+
📖 **Read the full spec:**[ GraphQL September 2025 Specification \
60+
](https://spec.graphql.org/September2025/) 🔎 **Review all changes:**[ Full changelog & diff \
61+
](https://github.com/graphql/graphql-spec/compare/October2021...f29fbcd2ab5af763fce7ad62896eb62465a669b3) 🤝 **Contribute:**[ How to get involved](https://github.com/graphql/graphql-spec/blob/main/CONTRIBUTING.md)

0 commit comments

Comments
 (0)