WordPress plugin

The SchemaX WordPress plugin delivers the complete site-side SchemaX setup to a WordPress site in one install, with no theme edits and no code. It collapses what would otherwise be three separate manual jobs into a single settings page, plus instant updates.

It is proven end to end: a stock WordPress site running only the plugin was verified by the same production engine that gates SchemaX’s own live verification.

What it installs

The plugin handles four things:

JSON-LD in the initial HTML. It fetches your published schema manifest and injects the right entities server-side, so your structured data lands in the page’s initial HTML, not added later by JavaScript. This matters because many AI crawlers do not run JavaScript. Per-page scoping is automatic: each page serves your site-wide entities plus the ones for that specific path.
The measurement snippet. Behind a toggle, it adds the outcome measurement snippet to your footer and keeps it in sync.
The /.well-known/ucp route. Standing up a well-known route is impossible on most hosts without server access. The plugin registers the route and serves your UCP manifest, passing a faithful 404 through when there is no eligible manifest to serve.
Instant updates. When you publish in SchemaX, it pings the site’s revalidation route and the next request serves fresh schema, with no waiting for a cache to expire.

Settings

Everything is configured under Settings → SchemaX:

Setting	Purpose
API base URL	The origin of your SchemaX API, e.g. `https://api.schemax.io`.
Project ID	The SchemaX project this site should serve.
Revalidation secret	A shared secret the API sends on publish to clear caches. It must match the secret configured in SchemaX.
Schema injection	Inject JSON-LD into the head, server-side. On by default.
Outcome measurement	Add the measurement snippet in the footer. On by default.

A Validate button fetches your public schema manifest and reports the project id, whether schema is published, and the current version, so you can confirm the connection before relying on it.

Requirements

WordPress 6.x with PHP 8.x. No Composer dependencies.
Pretty permalinks (not the “Plain” setting): the /.well-known/ucp route needs them so its rewrite rule resolves.
If your SchemaX API is behind a proxy, point API base URL at the externally reachable origin; the plugin uses it verbatim for every fetch and for the snippet source.

Safe by design

The plugin is built to never break your site. Every call to SchemaX is time-bounded and wrapped, and any failure (a network blip, a SchemaX issue) falls back to serving your page unchanged rather than erroring. Admin output is escaped, and the revalidation route is secret-gated with a constant-time comparison, failing closed when no secret is set.

What it does not change

The plugin reads from SchemaX’s public endpoints and serves their output. It does not edit your content, your theme, or your database beyond its own settings. Your schema is still reviewed and published in SchemaX; the plugin simply delivers it.