AI JSON-LD markup

Neural Schema & Structured Data

Generate, manage, and validate JSON-LD schema across your site using the Neural Schema engine — with separate Auto and Manual modes, per-post controls, and a unified Structured Data command center.

12 min read Pro feature Auto + Manual modes

Before you start

Neural Schema is SEO Rank Genius’s AI-powered JSON-LD engine. You manage it from the Structured Data tab — a site-wide command center with strict Auto/Manual controls, coverage stats, and a searchable table of every post and page.

Pro feature Structured Data and the post editor Schema tab require an active Pro license (Personal, Pro, or Agency). Free installs see a lock overlay until the license is activated under SEO Rank Genius → Account.

You’ll need:

  • WordPress Administrator access
  • An active paid SEO Rank Genius plan with cloud access for AI generation
  • Published posts or pages with real content (schema cannot generate on empty drafts)

For Organization and LocalBusiness fields used in business schema, fill in Indexing & Sitemaps → Website & Business first — that global profile feeds into generation.

FAQ rich results (2026) Google deprecated expanded FAQ rich results in standard Search as of May 2026. FAQPage schema still validates on schema.org and may help AI overviews, but it no longer produces expandable FAQ snippets in Google Search.

Open Structured Data

From your WordPress dashboard:

SEO Rank Genius → Indexing & Sitemaps → Structured Data

The tab lives under the AI & LLM section in the left sidebar (URL parameter: tab=structured-data).

At the top you’ll see:

AUTO / MANUAL switchToggle between the two mode panels below.
Coverage statsTotal posts/pages, With Schema, Missing, Manual Locked, Errors.
Mode panelAuto or Manual settings, type pickers, and bulk actions.
Posts & Pages tableFilter, search, paginate, and act on individual URLs.

Supported schema types are grouped into seven categories: Business & Local Services, Blogs/News, FAQ & SERP Enhancements, People & Authority, Website Structure, Events & Recipes, and Rich Media & Podcasts — covering types such as Article, BlogPosting, FAQPage, HowTo, Product, LocalBusiness, Organization, VideoObject, Recipe, JobPosting, and more.

Auto mode

Auto mode applies selected schema types to existing and newly published posts and pages without manual intervention per URL.

1

Switch to AUTO

Click the AUTO pill at the top of the Structured Data tab.

2

Enable and pick types

Turn on Enable Auto Mode, then check the schema types you want applied site-wide (e.g. BlogPosting for posts, WebPage for pages). You must select at least one type before saving.

3

Save and backfill

Click Save Auto Settings. Use Run Auto Backfill Now to generate schema for existing content immediately. A background hourly batch also processes remaining URLs when Auto mode is on.

Auto vs locked posts Posts with manual_locked status are skipped by Auto regeneration. Unlock them in the post editor or delete their schema before Auto can overwrite them.

Manual mode

Manual mode gives you explicit control: you choose schema types and run generation on selected posts. Manual output is saved as manual_locked and overrides Auto on those URLs.

1

Switch to MANUAL

Click the MANUAL pill and turn on Enable Manual Mode, then click Save Manual Settings.

2

Select types and posts

Check the schema types to generate under Manual Schema Types. In the Posts & Pages table below, select rows with the checkboxes.

3

Run bulk actions

  • Generate Selected — AI-generates schema for checked posts using the selected types
  • Bulk Delete Selected Schemas — removes stored schema from checked posts
  • Validate Selected — checks JSON-LD validity for checked posts
  • Validate Sitewide — runs validation across the site
  • Clear Selection — deselects all checked rows

A progress bar tracks bulk manual jobs. You can run Auto and Manual modes at the same time — Manual locked posts always take precedence over Auto on those URLs.

Posts & Pages table

The table lists every indexable post, page, and product with its current schema state.

Filters

  • Status — All, Has Schema, Missing, or Locked
  • Type — Posts, Pages, or Products
  • Search — filter by title

Row status values

generatedAI schema is stored and output on the frontend.
manual_lockedHand-edited or manually generated — protected from Auto overwrite.
missingNo schema stored for this URL yet.
errorGeneration failed — check the error message in the post editor Schema tab.

Per-row actions

  • View — opens a JSON modal (copy raw JSON, copy as <script>, test in Google or Schema.org)
  • Generate — run AI generation for that single post
  • Delete — remove stored schema
  • Debug — inspect generation diagnostics
  • Edit / Live — jump to the WordPress editor or public URL

The Flow Audit section at the bottom includes Audit Selected Output to compare stored schema against what is actually emitted on the frontend.

Per-post Schema tab

You can also manage schema while editing any post or page:

Post editor → SEO Rank Genius – Link Analysis → Schema tab

The Schema tab shows:

  • Current status, schema types in the @graph, confidence score, and last updated time
  • AI Schema Generation — pick a type or use Auto-detect (AI analyzes content), then click Generate Schema
  • Detect Content — previews what the AI detected (FAQs, lists, media) before generating
  • View JSON / Edit — inspect or hand-edit JSON-LD; saving edits uses Save & Lock to set manual_locked status
  • Add Schema Type — append an additional type to the existing graph on the same URL
  • Unlock — removes the lock so Auto or regeneration can run again
Synced everywhere Schema generated in the post editor appears in the Structured Data table, and vice versa. Both write to the same stored graph and frontend output.

Schema can only be generated on published posts. Drafts show a notice to publish first.

Validation & testing

After generation, confirm markup is valid and visible:

  1. Use Validate Selected or Validate Sitewide in Manual mode
  2. Open the JSON modal and click Test URL in Google (Rich Results Test) or Test URL in Schema.org
  3. In the post editor Schema tab, use Test in Google for a one-click Rich Results Test on that permalink
  4. View page source on the live URL — look for the block wrapped in <!– SEO Rank Genius – Structured Data –> comments
Local template fallback When the cloud generator cannot return a requested type, SEO Rank Genius can build Google-compliant local templates for common types (Article, FAQPage, Product, LocalBusiness, and others) so you still get valid JSON-LD.

Conflicts & output

Duplicate JSON-LD from multiple plugins causes validation errors and unpredictable rich results. SEO Rank Genius handles this in two layers:

  • Targeted blocking — disables schema output from Yoast SEO, Rank Math, AIOSEO, SEOPress, WooCommerce (when the SLG WooCommerce module is active), Genesis, GeneratePress, Kadence, and other known sources via WordPress filters
  • Output buffer cleanup — strips competing application/ld+json scripts from the final HTML while preserving SEO Rank Genius’s own marked block

Your schema is output once in wp_head as a JSON-LD script inside HTML comment markers. Each post can carry multiple schema types combined in a single @graph.

Best practice Pick one plugin as your schema source. If SEO Rank Genius is managing structured data, disable schema output in Yoast, Rank Math, or other SEO plugins to avoid fighting over the same URLs.

Troubleshooting

Lock overlay on Structured Data tab

Activate your Pro license under SEO Rank Genius → Account. Confirm your cloud connection is active if generation requests fail.

“Select at least one schema type for Auto mode”

Check at least one type in the Auto Schema Types grid before clicking Save Auto Settings.

Generate button disabled or “Publish this post”

Schema generation requires a published post with content. Publish (or re-publish) the post, then retry.

Schema locked — cannot regenerate

Manual edits and Manual-mode bulk generation set manual_locked. Click Unlock in the post editor Schema tab, or delete the schema from the Structured Data table, before running Auto or Generate again.

Status shows error

Open the post in the editor → Schema tab for the error message. Common causes: empty content, cloud timeout, or invalid JSON after a manual edit. Fix the content or JSON, unlock if needed, and regenerate.

Rich Results Test shows no schema

Clear full-page cache (hosting or cache plugin). Confirm the post status is generated or manual_locked in the table. Check page source for the SEO Rank Genius structured data comment block.

Duplicate schema warnings

Another plugin or theme may still inject JSON-LD. Disable their schema features, or deactivate the competing plugin. SEO Rank Genius’s conflict system runs on every front-end request when Neural Schema is loaded.