Write and edit in WordPress. Let visitors read your Next.js website. This bridge helps Next.js use the SEO title, description, search instructions, sharing tags and schema created by Rank Math.
Rank Math is a WordPress SEO plugin. You use it to set how your pages appear in search results and when people share links. Install Rank Math separately; its code is not included in this bridge.
Explore Rank Math (affiliate link)
Affiliate disclosure: If you make a qualifying purchase through this link, this project's owner may earn a commission. A paid Rank Math plan is not required to use this bridge.
Our main Next.js setup uses WPGraphQL to ask for content and SEO together. WPGraphQL remains optional for the WordPress plugin. Developers using REST can enable the separate public-post SEO endpoint. The plugin does not switch APIs automatically. All bridge features start off.
Other optional features fix supported SEO page addresses, adapt Rank Math's IndexNow notices, open published View links on the public website, add CMS noindex instructions or stop WordPress email.
Test the bridge on a copy of your site before changing a live site. It does not cover every Rank Math feature. The frontend examples must be added to your Next.js app; the plugin does not build or deploy that app.
For either SEO API, install and activate Rank Math, enable its Headless CMS Support and make sure PHP DOM is available. Ask your host about PHP DOM if needed. Drafts, private posts and password-protected posts do not receive public bridge SEO.
The current version supports published posts, pages and selected public custom post types. Archive pages, sitemaps, redirects, 404 reporting and automatic Next.js cache updates are not included. See the validation guide for tested versions and remaining checks.
IndexNow needs a current verification key file on the public website. Keep an existing .txt filename with the optional public key path setting. A public read-only key endpoint is available only while the IndexNow adapter is enabled. A submission does not guarantee indexing. CMS noindex does not add a login or prevent access. Leave email suppression off if WordPress must send password resets or notices.
This project is open source under GPL-3.0-or-later. Thank you to the Rank Math team and contributors for Rank Math SEO and its headless support, which make this bridge possible. This is an independent community project; these credits do not claim Rank Math's approval or support. Rank Math's code is not bundled here.
Official Rank Math source:
https://github.com/rankmath/seo-by-rank-math
Headless CMS guide:
https://rankmath.com/kb/headless-cms-support/
About ReadySpace
ReadySpace provides cloud and hosting services for businesses. ReadySpace and community contributors develop and share this free, open-source bridge. You can use it with your chosen hosting provider; a ReadySpace account is not required.
Learn about ReadySpace
Start with the
beginner setup guide. Read the
tests and limits before using it on a live site. Setup guides and Next.js examples are available on GitHub; they are not included in the WordPress ZIP. The ZIP includes the plugin, licence, changelog and credits.
Source code and contributions
0.3.0
Preserve an existing IndexNow key-file path, read the current public verification key, and validate automatic and manual Rank Math payloads with one shared policy. Configure source aliases, private frontend paths and trailing slashes without changing the SEO APIs. Reject entire invalid batches and protect known private, password-protected, nonindexable or externally canonicalized posts. No key rotation or history reset.
0.2.1
Use the distinctive ReadySpace Headless SEO Bridge for Rank Math name, with a matching directory folder and text domain. Existing bridge settings, SEO APIs and Next.js helpers stay compatible. Follow the migration guide when replacing an older ZIP.
0.2.0
Prepared first public release with directory documentation, external-service disclosure and packaging that matches the plugin slug. Optional WPGraphQL SEO supports published content; Next.js App Router examples are available on GitHub.
0.2.0-alpha.1
Optional WPGraphQL SEO, a shared generator, App Router examples, query-context fixes and real WordPress/Next.js checks. Beginner guides lead with WPGraphQL and credit Rank Math.
0.1.0
Initial alpha with optional features, a public-post SEO endpoint, frontend examples and community guides.