GraphQL RFC Tracker

The following is a rough tracker of GraphQL RFCs, compiled and maintained by Benjie. It does not claim to be a complete, accurate, or up to date representation of the RFCs; it is generated in part by automated scripts but may be helpful for people to keep track of the various RFCs.

Not up to date?

Ping @benjie on the GraphQL Discord (#wg channel) and ask for him to run an update!

Last updated: 2025-01-16T10:16:32.852Z

Stage 2: Draft

RFC	Champion	Title	Latest
#976	@benjie	Add 'extensions' to request	Added to 2025-01-09 WG agenda (more)
#1053	@benjie	Implementations may not deprecate a field that the interface hasn't deprecated	Added to 2025-01-09 WG agenda (more)
#794	@magicmark	Schema Coordinates	2 commits pushed: (latest) on 2025-01-02 by @magicmark (more)
#955	@benjaminjkraft	Add validation rule that operation types exist	Added to 2024-12-05 WG agenda (more)
#825	@benjie	OneOf Input Objects	5 commits pushed: (latest) on 2024-10-17 by @benjie (more)
#1102	@benjie	Define Data Collections used in the spec	Added to 2024-07-18 WG agenda (more)
#1063	@benjie	Type system ordering of: object interfaces, directive arguments, input object fields, enum values	Commit pushed: Clarify wording on 2024-07-01 by @benjie (more)
#1092	@benjie	Recommend that order of unordered collections is maintained where possible	Added to 2024-06-06 WG agenda (more)
#793	@benjie	Default value coercion rules	Added to 2023-12-07 WG agenda (more)
#860	@benjie	Prevent @skip and @include on root subscription selection set	Added to 2023-12-07 WG agenda (more)

Stage 1: Proposal

RFC	Champion	Title	Latest
#1056	@benjie	Fix CoerceArgumentValues() hasValue	Added to 2025-01-09 WG agenda (more)
#1058	@benjie	List coercion algorithm	Added to 2025-01-09 WG agenda (more)
#1110	@robrichard	Incremental Delivery spec draft	Commit pushed: skip deferred fragment spread when already in visited fragments on 2025-01-09 by @robrichard (more)
#1127	@benjie	When `sourceStream` errors, yield a `{ errors: [...] }` response	Added to 2025-01-09 WG agenda (more)
#997	@fotoetienne	Expand @deprecated to Objects	Added to 2024-11-07 WG agenda (more)
#1081	@JoviDeCroock	Fragment arguments/variables (syntax/validation/execution)	Added to 2024-10-03 WG agenda (more)
#1059	@benjie	Introduce Strict and Legacy All Variable Usages Are Allowed	Added to 2023-12-07 WG agenda (more)
#950	@yaacovCR	allow unions to include interfaces and unions	Added to 2022-08-04 WG agenda (more)
#939	@yaacovCR	allow unions to declare implementation of interfaces	Added to 2022-06-02 WG agenda (more)
#907	@IvanGoncharov	Add support for directives on directives	Added to 2022-01-06 WG agenda (more)
#892	@IvanGoncharov	Add descriptions to executable definitions	Spec PR created on 2021-10-07 by IvanGoncharov (more)
#509	@taion	Allow singular variables in list locations	Commit pushed: Remove CoerceVariableValues on 2018-09-01 by @taion (more)

Stage 0: Strawman

RFC	Champion	Title	Latest
#1114	@yaacovCR	add __directive meta field parallel to __type	Added to 2024-11-07 WG agenda (more)
#1057	@benjie	Fix coercion table for list	Added to 2024-10-03 WG agenda (more)
DeferStream	-	GraphQL Defer and Stream Directives	RFC document updated on 2024-09-19 by Rob Richard (more)
SchemaCoordin…	-	Schema Coordinates	RFC document updated on 2024-02-08 by Benjie (more)
#1065	@benjie	SemanticNonNull type (null only on error)	Commit pushed: Add IsValidImplementationFieldType updates on 2024-01-03 by @benjie (more)
ClientControl…	-	Client Controlled Nullability	RFC document updated on 2023-11-28 by Benjie Gillam (more)
InputUnion	-	GraphQL Input Union	RFC document updated on 2023-11-28 by Benjie Gillam (more)
FeatureDiscov…	-	Feature Discovery	RFC document updated on 2023-11-28 by Benjie Gillam (more)
Struct	-	Polymorphic-capable composite symmetric input/output type (`struct`)	RFC document updated on 2023-11-28 by Benjie (more)
#1049	@martinbonnin	Introduce SourceSchemaDocument and FullSchemaDocument	2 commits pushed: (latest) on 2023-11-20 by @martinbonnin (more)
wg#1410	@leebyron	Strict Semantic Nullability	WG discussion created on 2023-10-05 by leebyron (more)
#1050	@benjie	Directive proposal for opting out of null bubbling	Spec PR created on 2023-10-05 by benjie (more)
wg#1394	@captbaritone	True Nullability Schema	WG discussion created on 2023-09-12 by captbaritone (more)
#1045	@benjie	Remove fragmentSpreadName from visitedFragments when visit is complete	Spec PR created on 2023-09-11 by benjie (more)
FullSchemas	-	Full Schemas	RFC document created on 2023-08-26 by Martin Bonnin (more)
#1015	@leebyron	"Root" Types clarity → "Operation Type"	Added to 2023-03-02 WG agenda (more)
FragmentArgum…	-	Fragment Arguments	RFC document created on 2023-02-10 by Matt Mahoney (more)
wg#1239	@mjmahone	Fragment Arguments: RFC + Implementation Details	WG discussion created on 2023-01-19 by mjmahone (more)
#998	@yaacovCR	add spec edits for references	Spec PR created on 2022-11-03 by yaacovCR (more)
OptInFeatures	-	Opt-in features	RFC document updated on 2022-09-30 by Martin Bonnin (more)
ExpandingSubt…	-	Expanding Subtyping (for output types)	RFC document created on 2022-08-31 by Yaacov Rydzinski (more)
AnnotationStr…	-	Annotation Structs	RFC document updated on 2022-08-31 by Benjie (more)
MetadataStructs	-	Metadata Structs	RFC document updated on 2022-08-16 by Benjie (more)
wg#1096	@leebyron	"Metadata Directives" Proposal	WG discussion created on 2022-08-04 by leebyron (more)
CompositeSche…	-	GraphQL Composite Schemas	RFC document updated on 2022-07-22 by Daniel Winter (more)
wg#1071	@benjie	Struct type	WG discussion created on 2022-07-18 by benjie (more)
#673	@spawnia	Servers must preserve lexical ordering between SDL and introspection	2 commits pushed: (latest) on 2022-06-16 by @spawnia (more)
#948	@benjie	OneOf Objects	Added to 2022-06-02 WG agenda (more)
wg#944	@yaacovCR	New Intersection Type	WG discussion created on 2022-04-30 by yaacovCR (more)
wg#857	@mjmahone	Fragment Modularity	WG discussion created on 2022-01-07 by mjmahone (more)
FragmentModul…	-	Fragment Modularity	RFC document created on 2022-01-06 by Matt Mahoney (more)
wg#815	@leebyron	Nested GraphQL Mutations	WG discussion created on 2021-12-02 by leebyron (more)
ImplicitInher…	-	Implicit Inheritance	RFC document updated on 2021-09-03 by Lee Byron (more)
OperationExpr…	-	Operation Expressions	RFC document created on 2021-09-02 by Benjie Gillam (more)
SchemaFragments	-	Schema Fragments	RFC document created on 2021-09-02 by Daniel Starns (more)
#879	@mjmahone	__fulfilled meta field	Added to 2021-09-02 WG agenda (more)
Subscriptions	-	NOTE: this document is kept for historic purposes; GraphQL Subscriptions have been specified and released as part of the official [June 2018 GraphQL Specification](https://spec.graphql.org/June2018/).	RFC document updated on 2020-08-19 by Benjie Gillam (more)
#710	@chemisus	Add namedType and punctuatedName to __Type	Added to 2020-05-07 WG agenda (more)
#706	@francisu	Add support for directives for an object field name	Spec PR created on 2020-04-07 by francisu (more)
#674	@kassens	allow empty selections	Spec PR created on 2020-01-21 by kassens (more)
#631	@victorandree	Make root query operation type optional	Added to 2019-12-05 WG agenda (more)
#567	@benhead	allow directives on directive definitions	Spec PR created on 2019-02-28 by benhead (more)
#556	@langpavel	Document Directives	Commit pushed: Document directives are not special on 2019-02-01 by @langpavel (more)
#521	@IvanGoncharov	Scalar serialize as built-in scalar type	Spec PR created on 2018-10-14 by IvanGoncharov (more)
#325	@IvanGoncharov	Add "Any" scalar type	Spec PR created on 2017-06-19 by IvanGoncharov (more)

Stage 3: Accepted

RFC	Champion	Title	Latest
#525	@smitt04	Allow deprecation of input values	Mentioned in 2021-02-04 WG notes (more)
#823	@benjie	operation expressions	2 commits pushed: (latest) on 2021-03-16 by @benjie (more)
#667	@lilianammmatos	[RFC Sketch] Defer and Stream Directives	Added to 2020-01-09 WG agenda (more)
#1040	@martinbonnin	Make the reason argument in `@deprecated` non-nullable	Added to 2024-12-05 WG agenda (more)
#1073	@martinbonnin	Be strict about error paths format	Added to 2024-04-04 WG agenda (more)
#987	@benjie	Fix ambiguity around when schema definition may be omitted	Commit pushed: add related definition and specific example on 2023-02-09 by @leebyron (more)
#891	@dugenkui03	Add explanation about argument name uniqueness.	Added to 2023-02-02 WG agenda (more)
#805	@IvanGoncharov	Allow deprecation of input values (field args, directive args, input fields)	Commit pushed: Editorial on 2022-06-03 by @leebyron (more)
#849	@leebyron	Allow full unicode range	Commit pushed: Editorial on 2022-06-02 by @leebyron (more)
#776	@benjie	__typename is not valid at subscription root	Added to 2021-05-13 WG agenda (more)
#649	@eapache	Custom Scalar Specification URLs	2 commits pushed: (latest) on 2021-04-09 by @leebyron (more)
#803	@benjie	Replace 'query error' with 'request error'	2 commits pushed: (latest) on 2021-04-07 by @leebyron (more)
#701	@spawnia	Disallow non-breakable chains of circular references in Input Objects	2 commits pushed: (latest) on 2021-01-11 by @leebyron (more)
#373	@mike-marcacci	Allow interfaces to implement other interfaces	5 commits pushed: (latest) on 2020-01-11 by @leebyron (more)
#472	@OlegIlyenko	Repeatable directives	2 commits pushed: (latest) on 2020-01-10 by @leebyron (more)
#599	@leebyron	Clarify that lexing is greedy	Added to 2019-10-10 WG agenda (more)
#601	@leebyron	Number value literal lookahead restrictions	Added to 2019-10-10 WG agenda (more)
#598	@leebyron	Avoid parse ambiguity on types & extensions	Added to 2019-08-01 WG agenda (more)
#510	@mjmahone	Allow directives on variable definitions	Spec PR created on 2018-08-29 by mjmahone (more)
#470	@OlegIlyenko	"Directive order is significant" section	Spec PR created on 2018-06-23 by OlegIlyenko (more)
#466	@IvanGoncharov	Add description to Schema	Spec PR created on 2018-06-13 by IvanGoncharov (more)
#463	@leebyron	Ensure validation of directive arguments	Spec PR created on 2018-06-11 by leebyron (more)
#462	@leebyron	Input & Output type definition	Spec PR created on 2018-06-11 by leebyron (more)
#459	@mjmahone	Remove Interface is implemented by 1+ Objects validation	Spec PR created on 2018-06-08 by mjmahone (more)
#454	@IvanGoncharov	Add validation steps for schema extensions	Spec PR created on 2018-06-04 by IvanGoncharov (more)

Stage X: Rejected

RFC	Champion	Title	Latest
#1091	@benjie	Define Data Collections used in the spec	Added to 2024-06-06 WG agenda (more)
#742	@robrichard	Spec edits for @defer/@stream	Commit pushed: CollectFields does not require path or asyncRecord (#11) on 2023-01-16 by @yaacovCR (more)
#1098	@Shane32	Add 5.2.4 Operation Type Exists	2 commits pushed: (latest) on 2024-10-04 by @Shane32 (more)
#1010	@mjmahone	Fragment Arguments: Spec Implementation	Added to 2024-02-01 WG agenda (more)
#865	@mjmahone	Fragment Arguments (parameterized fragments) for GraphQL	Commit pushed: Split RFC doc into graphql-wg PR on 2023-01-11 by @mjmahone (more)
#895	@twof	Client Controlled Nullability	Commit pushed: updated to reflect newest behavior on 2022-05-13 by @twof (more)
#883	@IvanGoncharov	Relax SameResponseShape algorithm to be compatible with covariant fields	Spec PR created on 2021-09-02 by IvanGoncharov (more)
#877	@IvanGoncharov	Forbid duplicating argument names	Spec PR created on 2021-07-01 by IvanGoncharov (more)
#733	@benjie	Tagged type	Commit pushed: Separate input and output tagged types on 2021-01-21 by @benjie (more)
#395	@tgriesser	inputUnion type	Spec PR created on 2018-01-11 by tgriesser (more)
#1126	@benjie	GraphQL Subscriptions should handle errors in the source stream	Spec PR created on 2024-11-21 by benjie (more)
#1052	@yaacovCR	deduplicated incremental delivery	8 commits pushed: (latest) on 2024-01-30 by @yaacovCR (more)
#1048	@benjie	Null-Only-On-Error / Semantically-Non-Null type (asterisk)	Added to 2023-10-05 WG agenda (more)
#1034	@yaacovCR	incremental delivery with deduplication + concurrent execution	Commit pushed: use identifiers instead of records when possible on 2023-09-28 by @yaacovCR (more)
#999	@yaacovCR	introduce ExecuteGroupedFieldSet, CollectRootFields and CollectSubfields	Added to 2023-06-01 WG agenda (more)
#1026	@yaacovCR	incremental delivery with deduplication + concurrent execution	Added to 2023-06-01 WG agenda (more)
#1018	@benjie	Alternative proposal for `@stream`/`@defer`	Added to 2023-04-06 WG agenda (more)
#1023	@yaacovCR	incremental delivery without branching	Spec PR created on 2023-03-24 by yaacovCR (more)
#960	@yaacovCR	Allow recursion within ResolveAbstractType	Added to 2022-07-07 WG agenda (more)
#888	@nojvek	Map type	Added to 2021-10-07 WG agenda (more)
#806	@benjie	__typename should be valid at subscription root	Spec PR created on 2020-12-05 by benjie (more)
#586	@benjie	Input Objects accepting exactly @oneField	2 commits pushed: (latest) on 2019-07-22 by @benjie (more)
#471	@OlegIlyenko	Limit uniqueness to `@skip`, `@include` and `@deprecated` directives	Commit pushed: Include `@deprecated` directive in the validation rule on 2018-06-25 by @OlegIlyenko (more)
#326	@leebyron	Scalar serialize as built-in scalar type	Spec PR created on 2017-06-20 by leebyron (more)
#319	@IvanGoncharov	Add '@ignoreIfUnknown' to allow forward compatibility for clients	Mentioned in 2020-02-06 WG notes (more)
#606	@victorandree	Support empty composite types	Added to 2019-12-05 WG agenda (more)
#460	@mjmahone	Require Interfaces to have 1+ Objects implementing	Commit pushed: Merge branch 'master' into rfc-interfaces-implemented on 2018-06-11 by @leebyron (more)
#315	@excitement-engineer	Support DateTime scalar	Spec PR created on 2017-05-26 by excitement-engineer (more)
#232	@stubailo	__id field for unique identifiers	Commit pushed: Remove .vscode from gitignore on 2016-10-31 by Sashko Stubailo (more)
#445	@spawnia	Disallow non-breakable chains of circular references in Input Objects	Added to 2019-11-07 WG agenda (more)