September 2025 Changelog

This describes the set of changes since the last edition of the GraphQL specification, October2021 (see prior changelog). It's intended to ease the review of changes since the last edition for reviewers or curious readers, but is not normative. Please read the specification document itself for full detail and context.

Thank you, contributors!

The last few years have seen GraphQL reach a wide breath of use, powering internal and external APIs at startups and enterprises, and integrating with various platforms and tools. Work contributed to GraphQL has fit into two priorities:

1. Maintain a stable base. With a huge ecosystem built atop GraphQL, it's our responsibility to put stability above all else. The vast majority of work has fixed inconsistencies, improved behavior in edge and corner cases, improve security, and avoid performance pitfalls.

2. Provide a productive expressive query language. GraphQL was designed with API consumers in mind, and this spec release includes significant improvements to the GraphQL query engine and language.

Significant contributions have been made since the last edition of the spec, and both of these priories remain active areas of investment with many exciting RFCs still in the works.

Over 100 commits made to the GraphQL spec since the last edition, most of which have dozens or hundreds of comments! It's a huge amount of work to champion these changes, and a great responsibility to evolve the technical foundations for this community and ecosystem.

Thank you!

• @leebyron, Editor

Contributors

Anyone is welcome to join working group meetings and contribute to GraphQL. See Contributing.md for more information. Thank you to these community members for their technical contribution to this edition of the GraphQL specification.

Generated with:

node scripts/generate-contributor-list.mjs October2021..HEAD

Notable contributions

A few notable changes in this edition:

• OneOf input objects, aka "input unions" (#825)
• Schema coordinates as a standard for GraphQL tooling and reporting (#794)
• Descriptions on documents, in motivation for AI-consumers (#1170)
• Broader support for deprecation across a GraphQL Schema (#805 #1040 #1053 #1142)
• GraphQL language has been updated to support the full Unicode range (#849)
• Countless editorial improvements! The spec is much easier to read and contribute to, with fewer ambiguities.

Changeset

• Github: all Accepted RFC PRs merged since last spec cut
• Github: all Editorial PRs merged since last spec cut
• Github: all changes since last spec cut

Listed in reverse-chronological order (latest commit on top).

Generated with:

git log October2021..f29fbcd2ab5af763fce7ad62896eb62465a669b3 --format="| [%h](https://github.com/graphql/graphql-spec/commit/%H) | %s | %an <%ae> %(trailers:key=Co-authored-by,valueonly,separator=%x20)" -- spec

Diff

Github: diff from last spec cut