Title: HeadlessNext Connector Author: aarudhnextgen Published: August 11, 2026 Last modified: August 11, 2026 --- Search plugins ![](https://ps.w.org/headlessnext-connector/assets/banner-772x250.png?rev=3642532) ![](https://ps.w.org/headlessnext-connector/assets/icon-256x256.png?rev=3642532) # HeadlessNext Connector By [aarudhnextgen](https://profiles.wordpress.org/aarudhnextgen/) [Download](https://downloads.wordpress.org/plugin/headlessnext-connector.1.0.0.zip) * [Details](https://wordpress.org/plugins/headlessnext-connector/#description) * [Reviews](https://wordpress.org/plugins/headlessnext-connector/#reviews) * [Installation](https://wordpress.org/plugins/headlessnext-connector/#installation) * [Development](https://wordpress.org/plugins/headlessnext-connector/#developers) [Support](https://wordpress.org/support/plugin/headlessnext-connector/) ## Description **HeadlessNext Connector** seamlessly links your WordPress CMS with modern decoupled frontends like **Next.js**, **Vercel**, **Nuxt**, **SvelteKit**, or **Remix**. When editors publish, update, or delete posts and pages in WordPress, HeadlessNext Connector sends a fast, asynchronous, non-blocking webhook (`POST` request) to your frontend API route. This triggers Incremental Static Regeneration (ISR), updating your static site’s cache instantly without rebuilding the entire website! ### Key Features: * **On-Demand ISR Revalidation:** Trigger instant cache invalidation on Next.js(` revalidatePath()` or `revalidateTag()`) when posts or pages change in WordPress. * **Asynchronous & Non-Blocking:** Fires requests in the background so WordPress post publishing is never delayed waiting for external server responses. * **Shared Secret Security:** Send an `X-HeadlessNext-Secret` HTTP header to verify that revalidation requests originate exclusively from your authorized WordPress site. * **Universal Compatibility:** Works with **any** active WordPress theme, Gutenberg block editor, Classic Editor, and custom REST API / GraphQL setups. * **Zero Overhead:** Completely inert when no Frontend URL is configured. Zero external tracking or phone-home requests. ## Screenshots [⌊Settings → HeadlessNext Connector configuration screen.⌉⌊Settings → HeadlessNext Connector configuration screen.⌉[ Settings HeadlessNext Connector configuration screen. ## Installation 1. Upload the `headlessnext-connector` directory to `/wp-content/plugins/` or install directly via **Plugins Add New** in your WordPress dashboard. 2. Activate **HeadlessNext Connector**. 3. Go to **Settings HeadlessNext Connector**. 4. Enter your Frontend Base URL (e.g. `https://my-site.com`) and Revalidation Path( e.g. `/api/revalidate`). 5. (Optional) Set a shared secret token for request verification. 6. Check **“Automatically ping the frontend on post publish or update”** and save changes. ### Quick Next.js App Router Integration Example Create `app/api/revalidate/route.ts` in your Next.js project: ``` import { revalidatePath } from 'next/cache'; import { NextResponse } from 'next/server'; export async function POST(request: Request) { const secret = request.headers.get('x-headlessnext-secret'); if (secret !== process.env.REVALIDATE_SECRET) { return NextResponse.json({ message: 'Invalid secret' }, { status: 401 }); } const body = await request.json(); const slug = body.slug || '/'; // Revalidate the updated page path revalidatePath(/${slug}`); ``` revalidatePath(‘/’); // Revalidate homepage list return NextResponse.json({ revalidated: true, now: Date.now() }); } ` ## FAQ ### Does this plugin require a specific WordPress theme? No! HeadlessNext Connector works standalone with any theme, including Twenty Twenty- Four or custom block/classic themes. ### How does On-Demand ISR work with Next.js? Next.js uses Incremental Static Regeneration (ISR) to serve fast static pages. When content changes in WordPress, HeadlessNext Connector sends a webhook payload containing the post ID, slug, and post type to your Next.js API route. Next.js then runs `revalidatePath()` to update that static page in the background. ### What data is sent in the Webhook payload? The POST JSON payload includes: * `post_id`: The ID of the post/page * `post_type`:‘ post’, ‘page’, etc. * `slug`: The URI slug of the post * `permalink`: Full permalink URL * `action`: ‘publish’, ‘update’, or ‘delete’ * `home_url`: The WordPress site home URL ### How do I secure my revalidation endpoint? Configure a **Revalidation Secret** in the settings page. HeadlessNext Connector sends this secret in the `X-HeadlessNext-Secret` request header. Check this header in your Next.js API route before calling `revalidatePath()`. ### Is there any performance impact on WordPress? None. All webhook pings use non-blocking HTTP requests (`wp_remote_post` with `blocking => false`), ensuring the WordPress admin publishing flow remains fast and responsive. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “HeadlessNext Connector” is open source software. The following people have contributed to this plugin. Contributors * [ aarudhnextgen ](https://profiles.wordpress.org/aarudhnextgen/) [Translate “HeadlessNext Connector” into your language.](https://translate.wordpress.org/projects/wp-plugins/headlessnext-connector) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/headlessnext-connector/), check out the [SVN repository](https://plugins.svn.wordpress.org/headlessnext-connector/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/headlessnext-connector/) by [RSS](https://plugins.trac.wordpress.org/log/headlessnext-connector/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial public release: settings page, non-blocking on-demand ISR revalidation webhook, secret header validation. ## Meta * Version **1.0.0** * Last updated **1 day ago** * Active installations **Fewer than 10** * WordPress version ** 6.4 or higher ** * Tested up to **7.0.4** * PHP version ** 7.4 or higher ** * Tags * [headless](https://wordpress.org/plugins/tags/headless/)[nextjs](https://wordpress.org/plugins/tags/nextjs/) [vercel](https://wordpress.org/plugins/tags/vercel/) * [Advanced View](https://wordpress.org/plugins/headlessnext-connector/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/headlessnext-connector/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/headlessnext-connector/reviews/) ## Contributors * [ aarudhnextgen ](https://profiles.wordpress.org/aarudhnextgen/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/headlessnext-connector/)