🚀 WPGraphQL v2.0.0 has officially been released! This is a major update that includes breaking changes, so if you’re using WPGraphQL in production, please review the details below to ensure a smooth upgrade.

👉 Technical Update: Breaking Changes

Why WPGraphQL v2.0?

The primary motivation behind this release was upgrading WPGraphQL’s underlying GraphQL-PHP library. This upgrade unblocks us from shipping long-awaited features, such as the @oneOf directive, which will enable polymorphic input types. I’ve been talking about this since 2017 (GitHub comment here), and we’re finally in a position to make it happen!

Additionally, this release encourages users to keep their server stack updated (PHP, WordPress, and related dependencies), leading to better performance, security, and long-term supportability.

What’s Changed in WPGraphQL v2.0?

🚨 Breaking Changes

Dropped support for PHP below 7.4
Dropped support for WordPress below 6.0
Error handling changes due to updates in graphql-php (see full details in the technical update post)

🔥 New Features Over the Last Few Months

While v2.0 itself doesn’t introduce major new features, recent releases included several improvements, all of which are now part of v2.0:

🛠 New Extensions Page
🖥 New CLI arguments in wp graphql generate
📂 New fields on MediaItem for file and filePath
🚨 New SemVer update checker (warns about breaking changes before updating)
⚡ New fields on EnqueuedAsset and EnqueuedScript

🔗 See full release notes

How to Upgrade to WPGraphQL v2.0

For many users, no immediate action is required. However, if you’re running an outdated version of PHP or WordPress, you’ll need to upgrade your stack before updating WPGraphQL.

Step 1: Check your PHP version (must be 7.4+) and WordPress version (must be 6.0+)
Step 2: Test your site and any WPGraphQL custom extensions in a staging environment
Step 3: Follow the upgrade guide:

👉 Technical Update: Breaking Changes

👉 General WPGraphQL Upgrading Guide

Where to Get Help?

If you run into issues or have questions, we encourage you to reach out:

💬 GitHub Issues – Report bugs or discuss issues

💬 Join the WPGraphQL Discord – Connect with the community

Special Thanks to Our Contributors

This release would not have been possible without the incredible contributions of our community, especially Dovid Levine (@justlevine), who put in countless late nights and weekends helping maintain WPGraphQL and grow the headless WordPress ecosystem. 🎉

What’s Next for WPGraphQL?

With v2.0 released, we’re excited to move forward on several highly requested features, including:

🛠 Custom Scalars
🏗 @oneOf Directive (enabling polymorphic input types)
📷 MediaItem Enhancements

Upcoming Event: Ask Questions Live!

I’ll be at the Headless WordPress Community Event on Monday, Feb 24, where you can ask questions about WPGraphQL v2.0 and beyond. This is hosted by the Headless WP Discord community—join here!

🚀 We’re excited for the future of WPGraphQL, and we appreciate all of you who have helped make this possible.

Happy querying!