You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/pages/blog/2025-09-08-september-edition.md
+14-19Lines changed: 14 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,14 +5,14 @@ date: 2025-09-08
5
5
byline: Lee Byron
6
6
---
7
7
8
-
It’s here: the[September 2025 edition of the GraphQL specification](https://spec.graphql.org/September2025/)!
8
+
It’s here: the[September 2025 edition of the GraphQL specification](https://spec.graphql.org/September2025/)!
9
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.
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
11
12
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
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
-
\
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
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
17
18
18
## **Why It Matters**
@@ -27,20 +27,15 @@ Several updates in this edition make GraphQL an even better foundation for AI as
27
27
## **Notable Updates**
28
28
29
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\
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](https://github.com/graphql/graphql-spec/pull/825)
32
31
-**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\
A standardized way to refer to parts of a schema, paving the way for better tooling, error reporting, and developer experience. [RFC #794](https://github.com/graphql/graphql-spec/pull/794)
35
33
-**Descriptions on Documents**\
36
-
Improved support for documenting queries and operations — helpful for humans and increasingly relevant for AI-powered tools.[ RFC #1170\
Improved support for documenting queries and operations — helpful for humans and increasingly relevant for AI-powered tools. [RFC #1170](https://github.com/graphql/graphql-spec/pull/1170)
38
35
-**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
-
36
+
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)\]
41
37
-**Full Unicode Support**\
42
-
\*\*The language grammar now supports the entire Unicode range, improving internationalization and accessibility.[ RFC #849\
The language grammar now supports the entire Unicode range, improving internationalization and accessibility. [RFC #849](https://github.com/graphql/graphql-spec/pull/849)
44
39
-**Editorial Improvements**\
45
40
The spec is clearer, more consistent, and easier to contribute to. Ambiguities have been reduced, and the style guide has been modernized.
46
41
@@ -50,12 +45,12 @@ This edition wouldn’t exist without the dedication of the GraphQL community. D
50
45
51
46
Special thanks to the many reviewers, implementers, and champions who shaped this release.
52
47
53
-
You can explore the full list of contributors in the[changelog](https://github.com/graphql/graphql-spec/blob/main/changelogs/September2025.md).
48
+
You can explore the full list of contributors in the[changelog](https://github.com/graphql/graphql-spec/blob/main/changelogs/September2025.md).
54
49
55
50
## **Get involved**
56
51
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.
52
+
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
53
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)
54
+
📖 **Read the full spec:**[GraphQL September 2025 Specification](https://spec.graphql.org/September2025/)\
55
+
🔎 **Review all changes:**[Full changelog & diff](https://github.com/graphql/graphql-spec/compare/October2021...f29fbcd2ab5af763fce7ad62896eb62465a669b3)\
56
+
🤝 **Contribute:**[How to get involved](https://github.com/graphql/graphql-spec/blob/main/CONTRIBUTING.md)
0 commit comments