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-06-26T19:21:25.609Z

Stage 3: Accepted (pending editorial)

RFC	Champion	Title	Latest
#1102	@benjie	Define Data Collections used in the spec GitHub	Added to 2025-06-26 WG agenda (more)
#825	@benjie	OneOf Input Objects GitHub	4 commits pushed: (latest) on 2025-06-12 by @benjie (more)
#793	@benjie	Default value coercion rules GitHub	Added to 2025-06-05 WG agenda (more)
#1092	@benjie	Recommend that order of unordered collections is maintained where possible GitHub	Added to 2025-05-01 WG agenda (more)

Stage 2: Draft

RFC	Champion	Title	Latest
#794 🚀	@magicmark	Schema Coordinates GitHub	Added to 2025-06-26 WG agenda (more)
#1063 🚀	@benjie	Type system ordering of: object interfaces, directive arguments, input object fields, enum values GitHub	Added to 2025-05-01 WG agenda (more)
#1170	@fotoetienne	Add descriptions to executable documents | 2025 Update GitHub	Added to 2025-06-26 WG agenda (more)
#1081	@JoviDeCroock	Fragment arguments/variables (syntax/validation/execution) GitHub	Commit pushed: Partial update, rest depends on https://github.com/graphql/graphql-sp… on 2025-02-15 by @JoviDeCroock (more)

Stage 1: Proposal

RFC	Champion	Title	Latest
#1058 🚀	@benjie	List coercion algorithm GitHub	Added to 2025-06-26 WG agenda (more)
#1056 🚀	@benjie	Fix CoerceArgumentValues() hasValue GitHub	Added to 2025-01-09 WG agenda (more)
#997	@fotoetienne	Expand @deprecated to Objects GitHub	Added to 2025-06-26 WG agenda (more)
#1163	@benjie	Service capabilities / error behaviors GitHub	Added to 2025-06-05 WG agenda (more)
#1110	@robrichard	Incremental Delivery spec draft GitHub	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 GitHub	Added to 2025-01-09 WG agenda (more)
#1059	@benjie	Introduce Strict and Legacy All Variable Usages Are Allowed GitHub	Added to 2023-12-07 WG agenda (more)
#950	@yaacovCR	allow unions to include interfaces and unions GitHub	Added to 2022-08-04 WG agenda (more)
#939	@yaacovCR	allow unions to declare implementation of interfaces GitHub	Added to 2022-06-02 WG agenda (more)
#907	@IvanGoncharov	Add support for directives on directives GitHub	Added to 2022-01-06 WG agenda (more)
#509	@taion	Allow singular variables in list locations GitHub	Commit pushed: Remove CoerceVariableValues on 2018-09-01 by @taion (more)

Stage 0: Strawman

RFC	Champion	Title	Latest
#521 🚀	@IvanGoncharov	Scalar serialize as built-in scalar type GitHub	Spec PR created on 2018-10-14 by IvanGoncharov (more)
InputUnion	-	NOTE: this document is kept for historic purposes; [`@oneOf`](https://github.com/graphql/graphql-spec/pull/825) gained RFC3 status in May 2025.	RFC document updated on 2025-06-05 by Benjie (more)
SemanticNulla…	-	Semantic Nullability	RFC document updated on 2025-05-01 by Benjie (more)
#1165	@benjie	Add Transitional Non-Null appendix (`@noPropagate` directive) GitHub	Spec PR created on 2025-04-30 by benjie (more)
FieldExtensions	-	Field Extensions	RFC document created on 2025-04-25 by Martin Bonnin (more)
#1065	@benjie	SemanticNonNull type (null only on error) GitHub	Added to 2025-04-03 WG agenda (more)
wg#1700	@leebyron	Lee's new nullability & error propagation proposal	WG discussion created on 2025-03-26 by leebyron (more)
DisableErrorP…	-	Disable Error Propagation Directive	RFC document created on 2025-03-19 by Alex Reilly (more)
#1050	@benjie	Directive proposal for opting out of null bubbling GitHub	4 commits pushed: (latest) on 2025-03-10 by @benjie (more)
ClientControl…	-	NOTE: this document is not being worked on at the moment, instead the Nullability WG are currently exploring an alternative solution that addresses many of the same underlying issues in a different way: [Semantic Nullability RFC](SemanticNullability.md).	RFC document updated on 2025-02-24 by Martin Bonnin (more)
#1114	@yaacovCR	add __directive meta field parallel to __type GitHub	Added to 2024-11-07 WG agenda (more)
#1057	@benjie	Fix coercion table for list GitHub	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)
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 GitHub	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)
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 GitHub	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" GitHub	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 GitHub	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 GitHub	2 commits pushed: (latest) on 2022-06-16 by @spawnia (more)
#948	@benjie	OneOf Objects GitHub	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 GitHub	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 GitHub	Added to 2020-05-07 WG agenda (more)
#706	@francisu	Add support for directives for an object field name GitHub	Spec PR created on 2020-04-07 by francisu (more)
#674	@kassens	allow empty selections GitHub	Spec PR created on 2020-01-21 by kassens (more)
#631	@victorandree	Make root query operation type optional GitHub	Added to 2019-12-05 WG agenda (more)
#567	@benhead	allow directives on directive definitions GitHub	Spec PR created on 2019-02-28 by benhead (more)
#556	@langpavel	Document Directives GitHub	Commit pushed: Document directives are not special on 2019-02-01 by @langpavel (more)
#325	@IvanGoncharov	Add "Any" scalar type GitHub	Spec PR created on 2017-06-19 by IvanGoncharov (more)

Stage 3: Accepted

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

Stage X: Superseded

RFC	Champion	Title	Latest
#823	@benjie	operation expressions GitHub	2 commits pushed: (latest) on 2021-03-16 by @benjie (more)
#667	@lilianammmatos	[RFC Sketch] Defer and Stream Directives GitHub	Added to 2020-01-09 WG agenda (more)
#892	@IvanGoncharov	Add descriptions to executable definitions GitHub	Added to 2025-06-05 WG agenda (more)
#1153	@benjie	Allow clients to disable error propagation via request parameter GitHub	Added to 2025-04-03 WG agenda (more)
#1157	@martinbonnin	Exclude custom scalar literals from validation GitHub	Spec PR created on 2025-04-02 by martinbonnin (more)
#1126	@benjie	GraphQL Subscriptions should handle errors in the source stream GitHub	Spec PR created on 2024-11-21 by benjie (more)
#1098	@Shane32	Add 5.2.4 Operation Type Exists GitHub	2 commits pushed: (latest) on 2024-10-04 by @Shane32 (more)
#1091	@benjie	Define Data Collections used in the spec GitHub	Added to 2024-06-06 WG agenda (more)
#1010	@mjmahone	Fragment Arguments: Spec Implementation GitHub	Added to 2024-02-01 WG agenda (more)
#1052	@yaacovCR	deduplicated incremental delivery GitHub	8 commits pushed: (latest) on 2024-01-30 by @yaacovCR (more)
#1048	@benjie	Null-Only-On-Error / Semantically-Non-Null type (asterisk) GitHub	Added to 2023-10-05 WG agenda (more)
#1034	@yaacovCR	incremental delivery with deduplication + concurrent execution GitHub	Commit pushed: use identifiers instead of records when possible on 2023-09-28 by @yaacovCR (more)
#999	@yaacovCR	introduce ExecuteGroupedFieldSet, CollectRootFields and CollectSubfields GitHub	Added to 2023-06-01 WG agenda (more)
#1026	@yaacovCR	incremental delivery with deduplication + concurrent execution GitHub	Added to 2023-06-01 WG agenda (more)
#1023	@yaacovCR	incremental delivery without branching GitHub	Spec PR created on 2023-03-24 by yaacovCR (more)
#742	@robrichard	Spec edits for @defer/@stream GitHub	Commit pushed: CollectFields does not require path or asyncRecord (#11) on 2023-01-16 by @yaacovCR (more)
#865	@mjmahone	Fragment Arguments (parameterized fragments) for GraphQL GitHub	Commit pushed: Split RFC doc into graphql-wg PR on 2023-01-11 by @mjmahone (more)
#877	@IvanGoncharov	Forbid duplicating argument names GitHub	Spec PR created on 2021-07-01 by IvanGoncharov (more)
#586	@benjie	Input Objects accepting exactly @oneField GitHub	2 commits pushed: (latest) on 2019-07-22 by @benjie (more)
#471	@OlegIlyenko	Limit uniqueness to `@skip`, `@include` and `@deprecated` directives GitHub	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 GitHub	Spec PR created on 2017-06-20 by leebyron (more)

Stage X: Rejected

RFC	Champion	Title	Latest
#1166	@benjie	Enable 'schema' keyword to be provided without root operations GitHub	Spec PR created on 2025-05-01 by benjie (more)
#1018	@benjie	Alternative proposal for `@stream`/`@defer` GitHub	Added to 2023-04-06 WG agenda (more)
#960	@yaacovCR	Allow recursion within ResolveAbstractType GitHub	Added to 2022-07-07 WG agenda (more)
#895	@twof	Client Controlled Nullability GitHub	Commit pushed: updated to reflect newest behavior on 2022-05-13 by @twof (more)
#888	@nojvek	Map type GitHub	Added to 2021-10-07 WG agenda (more)
#883	@IvanGoncharov	Relax SameResponseShape algorithm to be compatible with covariant fields GitHub	Spec PR created on 2021-09-02 by IvanGoncharov (more)
#733	@benjie	Tagged type GitHub	Commit pushed: Separate input and output tagged types on 2021-01-21 by @benjie (more)
#806	@benjie	__typename should be valid at subscription root GitHub	Spec PR created on 2020-12-05 by benjie (more)
#319	@IvanGoncharov	Add '@ignoreIfUnknown' to allow forward compatibility for clients GitHub	Mentioned in 2020-02-06 WG notes (more)
#606	@victorandree	Support empty composite types GitHub	Added to 2019-12-05 WG agenda (more)
#460	@mjmahone	Require Interfaces to have 1+ Objects implementing GitHub	Commit pushed: Merge branch 'master' into rfc-interfaces-implemented on 2018-06-11 by @leebyron (more)
#395	@tgriesser	inputUnion type GitHub	Spec PR created on 2018-01-11 by tgriesser (more)
#315	@excitement-engineer	Support DateTime scalar GitHub	Spec PR created on 2017-05-26 by excitement-engineer (more)
#232	@stubailo	__id field for unique identifiers GitHub	Commit pushed: Remove .vscode from gitignore on 2016-10-31 by Sashko Stubailo (more)