About PostGraphile V5​

Production-ready and already powering many apps, V5 is a complete ground-up rewrite powered by Grafast, our cutting-edge planning and execution engine for GraphQL. It dramatically reduces Postgres load, supports true polymorphism, and introduces incremental delivery, executable schema exports, greater control over your schema, and much more. Its efficient and ergonomic extensibility guides you into the pit of success. It even introduces an “eject button” for when you feel the need to move beyond an autogenerated schema!

V5 is now generally available!

• Overview of new features
• Intro to V5 series on dev.to
• V5 Documentation
• V4 → V5 migration guide

Try PostGraphile Version 5 today​

Try it now:

npx pgl -P pgl/amber -e -c 'postgres:///mydb'

Replace the connection string and schema with your own values. If you are upgrading from V4, follow the migration guide and let us know where it can be improved.

Epics - COMPLETE!​

With the help of the community, we identified four major issues in our new planning engine, Grafast. These issues related to ergonomics, edge cases, or efficiency; they all required changes to user code (“plan resolvers”), so addressing them before release was vital.

Since fixing these issues required fundamental changes to the way the system works — re-architectures that took many months to complete — we called them “epics”. All four are now complete, hurrah!

• ✅ Everything is batched, but “unary” values (variables, context, etc) are now treated as a special case.
• ✅ Early termination of field execution with a null now has first-class support.
• ✅ Plan-time “peeking” at runtime values is now forbidden, improving plan re-use (aka remove $step.eval*()).
• ✅ The exponential polymorphic branching hazard is now eradicated by converging before branching again (achieved June 2025).

Milestone releases​

Some of the more notable recent releases are listed below. Graphile sponsors have access to release notes through our community support channels. Everyone else can see some detail in the PostGraphile changelog.