BlueSoup AI Auto Schema

Description

BlueSoup AI Auto Schema is the most complete schema management system for WordPress. It’s the only plugin that reads your actual live page, generates accurate JSON-LD from real content, keeps your schemas automatically up to date as your site evolves, and optimizes your content for Google voice search and AI Overviews — all without touching a line of code.

Bring your own OpenAI key. AI generation uses your OpenAI account — you pay OpenAI directly. Using gpt-4.1-mini, generating a full schema typically costs a fraction of a cent.

The problem with every other schema plugin

Most schema plugins hand you a form to fill out. You type in a title, paste in a description, and hope you didn’t miss a required field. The schema gets saved, your content changes six months later, and now your structured data is stale — outdated dates, wrong descriptions, placeholders where real data should be. Google notices.

BlueSoup AI Auto Schema works differently. It reads your live page the same way Google does, extracts every signal it can find (title, meta tags, phone numbers, addresses, social links, images, existing JSON-LD), and generates schema that reflects your actual content. Then it watches for changes and tells you when to regenerate.

What sets this plugin apart

AI reads your page, not a form. When you click Generate, the plugin fetches your live URL and reads the full HTML — meta tags, Open Graph data, phone and email links, social profile links, existing structured data, and body text. It generates schema from what’s actually on your page, not from what you type into a box.

Your schemas stay current automatically. When you update a post, the dateModified in your Article and WebPage schemas updates automatically. If the content itself changes significantly, a yellow “⟳ Outdated” badge appears on the schema card — click it to regenerate in one click without opening the editor.

Voice search and AI citation optimization built in. Enable the Speakable section on any post and the plugin automatically injects a SpeakableSpecification into your Article and WebPage schemas at output time — no schema regeneration needed. Your post title and excerpt are pulled directly from WordPress (no fragile CSS selector detection), so what Google’s voice assistant reads is exactly what you expect.

Schema conflict detection and suppression. If Yoast SEO, RankMath, AIOSEO, or SEOPress are active, the plugin detects them and warns you about potential duplicate schemas. One checkbox disables their JSON-LD output on any specific page, giving you clean, non-conflicting structured data exactly where you want it.

Complete JSON-LD management in one place. Every page and post has its own schema list. Add multiple schemas per page (Article + BreadcrumbList + FAQPage on a single post), toggle them active/inactive, validate with a server-side checker, or force-save with warnings acknowledged.

Free features

  • AI-powered JSON-LD generation — works with any OpenAI-compatible key (gpt-4.1-mini recommended)
  • Live schema validation — instant client-side + server-side validation with specific, actionable error messages
  • Per-page schema manager — view, add, edit, delete, and toggle all schemas on any page or post
  • Multiple schemas per page — stack Article + BreadcrumbList + FAQPage + Organization on a single post
  • Staleness detection — yellow “⟳ Outdated” badge appears when post content changes after a schema was saved
  • Auto-sync dateModified — Article and WebPage schemas automatically keep their dateModified current on every post save (togglable per post)
  • Voice search & AI citation — per-post Speakable section with SpeakableSpecification auto-injected using your actual WordPress title and excerpt
  • Schema conflict management — detects Yoast SEO, RankMath, AIOSEO, and SEOPress; per-page toggle to suppress their JSON-LD output
  • Business information settings — enter name, address, phone, logo, email, and social profiles once; injected into every AI prompt
  • Quick links — “ Open page” and “🔍 Test in Google Rich Results” links for every loaded post
  • Smart AI prompts — explicit rules for Product brand, price format, shippingDetails, hasMerchantReturnPolicy, BreadcrumbList item URLs, and more
  • Product schema post-processor — auto-fixes brand @type, falls back to logo as product image, and sets price placeholder for dynamic-pricing pages
  • BreadcrumbList auto-fix — automatically fills in the missing “item” URL on the last list entry (the most common BreadcrumbList validation error)
  • Priority output — schemas inject before Yoast SEO (priority 0 vs priority 1)
  • @graph unwrapping — AI-generated @graph schemas are silently split into individual <script> blocks to prevent duplicate @graph roots
  • Debug log — view the last 25 AI generation calls with token counts, schema types, and any validation warnings
  • 20+ schema types (see list below)

Supported schema types

Article, BlogPosting, NewsArticle, WebPage, FAQPage, Recipe, Discussion / Forum Post, Profile Page, Organization, LocalBusiness, Restaurant, Hotel, Medical Business, Legal Service, Person, Product, Product Group (variants), Offer, Service, Software Application, Web Application / SaaS, Event, Conference Event, Performing Arts Event, Course, Job Posting, Video, Image, Audio, Review, Aggregate Rating, Web Site, Breadcrumb List, Sitelinks Search Box, Contact Page — and any custom Schema.org type.

Pro features

Pro license at bluesoup.biz

  • Global Schemas — create Organization, WebSite, or any schema that injects on every page of your site. One place to manage your site-wide structured data. No more adding the same Organization schema to 200 pages.
  • ✨ Generate All Recommended — one click analyses your page and generates every schema type it qualifies for (Article + BreadcrumbList + FAQPage in a single AI call), then saves them all automatically
  • Row actions in Posts/Pages lists — “Edit Schema” and “Add Schema” links appear directly on every post in the admin list screens — jump to schema management in one click without navigating away
  • Schema meta box in post editor — a “Schema Markup” sidebar panel in the WordPress block editor and classic editor shows active schema counts and provides a direct link to manage them without leaving the post

Who is this for?

  • SEO professionals managing structured data across client sites who need a reliable, non-fragile workflow that doesn’t break when clients update their content
  • WordPress developers who want correct, complete schema without maintaining custom code or hunting down outdated JSON-LD in theme files
  • Business owners who want rich results — star ratings, FAQs, breadcrumbs, product prices — but don’t want to learn JSON-LD syntax
  • Bloggers and publishers who want Article, BreadcrumbList, and Speakable schema on every post, automatically kept current, without a plugin conflict minefield
  • Anyone targeting AI search — FAQPage and Speakable schemas significantly improve visibility in Google AI Overviews, ChatGPT browsing, and voice search results

External Services

This plugin connects to the following external services:

OpenAI API (api.openai.com)

Used to generate JSON-LD schema markup. When you click “Generate with AI,” your page’s URL, title, schema type, and business information from Settings are sent to OpenAI. This only happens when you explicitly trigger generation — never automatically. You must supply your own API key.

  • OpenAI Privacy Policy: https://openai.com/privacy
  • OpenAI Terms of Use: https://openai.com/terms

BlueSoup License Server (bluesoup.biz) — Pro only

Used to validate Pro license keys and deliver plugin updates. Your license key and site domain are sent to bluesoup.biz for verification. Checked once per day and cached.

  • BlueSoup Privacy Policy: https://bluesoup.biz/privacy/

BlueSoup Promotional Content (bluesoup.biz/plugin-promos.json)

A small JSON file fetched once every 7 days to display information about other BlueSoup plugins in the admin. No data is sent — GET request only. Only occurs in the WordPress admin, never on the public front end.

Screenshots

  • Schema Manager — select any page or post to view and manage its schemas, with staleness detection and quick links.
  • Schema editor — edit JSON-LD with live validation, a “Valid” indicator, and one-click AI generation.
  • Speakable section — enable voice search and AI citation optimization per post with automatic WordPress data injection.
  • Settings — enter business details once and the AI uses them in every schema it generates.

Installation

  1. Install through the WordPress Plugins screen (search “BlueSoup AI Auto Schema”) or upload the zip via Upload Plugin.
  2. Activate the plugin.
  3. Go to BlueSoup AI Auto Schema in the admin menu.
  4. Open Settings — enter your business name, address, phone, logo URL, social profiles, and OpenAI API key.
  5. Go to Schema Manager, choose a page or post, and click Load Schemas.
  6. Click + Add New Schema, pick a type, and click ✨ Generate with AI.

FAQ

Do I need an OpenAI account to use this plugin?

Only for AI generation. You can write JSON-LD manually and use the live validator without any API key. To use AI generation, you need an API key from platform.openai.com. New OpenAI accounts include free trial credits.

How much does AI generation cost?

Using gpt-4.1-mini, a single schema generation typically uses 300–700 tokens — roughly $0.001 or less. A month of active schema generation on a busy site costs less than a cup of coffee.

Does adding schema slow down my site?

No. JSON-LD is a static <script> block in <head>. There is no front-end JavaScript, no external requests, and no render-blocking resources. The performance impact is negligible.

What is JSON-LD and why does it matter for SEO?

JSON-LD (JavaScript Object Notation for Linked Data) is Google’s preferred format for structured data markup. It tells Google what your content is about — whether it’s an article, a product, a local business, a FAQ, or an event. Google uses this information to display rich results in search listings, which typically generate much higher click-through rates. It also feeds AI Overviews and voice search results.

What is Speakable schema and why should I use it?

SpeakableSpecification tells Google’s voice assistant and AI systems which parts of your page contain the most important, spoken-word-appropriate content. When enabled, the plugin automatically adds it to your Article and WebPage schemas using your actual WordPress post title and excerpt — no configuration needed. This improves your visibility in Google voice search, Google Assistant responses, and AI Overviews.

Can I add multiple schemas to one page?

Yes. You can add as many schemas as needed per page. Each one is output as a separate <script type="application/ld+json"> block. A typical blog post might have BreadcrumbList + Article + FAQPage all at once.

Will this conflict with Yoast SEO, RankMath, or All in One SEO?

The plugin detects active SEO plugins and displays a warning in the Schema Manager. You can use the per-page “Disable other plugins’ schema output” toggle to suppress their JSON-LD on any specific page, preventing duplicate schema types in search results.

What is the Global Schemas feature?

Global Schemas (Pro) let you create schemas that inject on every page of your site — no per-page setup needed. This is the correct way to implement Organization and WebSite schemas, which should appear site-wide. Available in the Pro version.

How does the AI know my business details?

Go to Settings and fill in your Business Name, Address, Phone, Email, Logo URL, and social profiles. These values are injected into every AI prompt so the generated schemas use your real data instead of guessing or using placeholders.

What is staleness detection?

When your post content is updated after a schema was last saved, the Schema Manager shows a yellow “⟳ Outdated” button on that schema. Click it to immediately regenerate with AI. The dateModified field also auto-syncs on every post save via the Auto-sync dateModified setting.

Where is my schema data stored?

All settings and schemas are stored in your WordPress database. Content is only sent to OpenAI during AI generation that you manually trigger — nothing is sent automatically or in the background.

What happens to my schemas if I deactivate the plugin?

Your settings and saved schemas remain in the database. They will not be output on the front end while the plugin is deactivated, but they will be restored immediately when you reactivate it.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“BlueSoup AI Auto Schema” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

3.0.0

  • Voice search & AI citation — new per-post Speakable section injects SpeakableSpecification into Article and WebPage schemas at output time using your actual WordPress title and excerpt — no CSS selector detection, no fragile DOM parsing, no configuration required. Description auto-populated from post excerpt or first paragraph.
  • Schema staleness detection — Schema Manager shows a yellow “⟳ Outdated” badge on any schema whose post content changed after the schema was last saved, with one-click AI regeneration
  • Auto-sync dateModified — Article and WebPage schemas automatically keep dateModified current whenever you save the post in WordPress. On by default, togglable per post.
  • Schema conflict management — detects Yoast SEO, RankMath, AIOSEO, and SEOPress; warning appears above the toggle to disable their JSON-LD on any specific page to prevent duplicate schemas in search results
  • Quick links — “ Open page” and “🔍 Test in Google Rich Results” links appear in the Schema Manager for every loaded post
  • Product schema post-processor — auto-fixes brand @type from Organization to Brand, uses logo as product image fallback, sets priceSpecification.minPrice placeholder for dynamic-pricing pages
  • BreadcrumbList auto-fix — automatically fills in the missing “item” URL on the last list entry
  • @graph unwrapping — AI-generated @graph schemas are silently split into individual <script> blocks at output time, preventing duplicate @graph roots when used alongside Yoast
  • Priority 0 output — schema blocks inject before Yoast SEO (priority 1) and all other SEO plugins
  • AI prompt overhaul — explicit rules for Product brand, price format, shippingDetails, hasMerchantReturnPolicy, BreadcrumbList item URLs, aggregateRating/review fabrication prevention, image detection, and sameAs social URL extraction
  • Site information injection — business name, address, phone, logo, email, and social profiles injected into every AI prompt for accurate, non-hallucinated schema values
  • Speakable preview shows matched headline text and WordPress description text with edit links when excerpt is missing
  • bfcache guard resets all UI state on browser back/forward navigation

2.0.10

  • Speakable: replaced fragile CSS selector detection with WordPress-native data — description auto-populated from post excerpt or first paragraph, no AI detection needed
  • Speakable: simplified UI — removed intro selector and “Detect with AI” button; headline defaults to h1
  • Speakable: preview shows matched headline and description text with direct edit link when no excerpt is set

2.0.9

  • Schema Overlap Warning moved directly above the “Disable other plugins’ schema” checkbox
  • Speakable redesigned as per-post feature with AI-based CSS selector detection and output-time injection

2.0.8

  • Schema staleness detection with “⟳ Outdated” regeneration button
  • Auto-sync dateModified on post save
  • Quick links: “ Open page” and “🔍 Test in Google Rich Results”
  • Speakable schema with CSS selector configuration in Settings

2.0.7

  • Schema output at wp_head priority 0 (before Yoast SEO)
  • @graph-wrapped schemas automatically unwrapped into individual blocks
  • AI prompt updated to always return single typed JSON objects

2.0.6

  • BreadcrumbList post-processor auto-fills missing “item” URL on last ListItem
  • Per-page “Disable other plugins’ schema” toggle in Schema Manager

2.0.5

  • Plugin icon and banner images fixed in WordPress Updates screen
  • OpenAI request timeout increased to 120 seconds
  • AI connection errors now show actionable messages instead of raw cURL codes

2.0.4

  • Product schema post-processor: brand @type fix, image fallback, price placeholder
  • Prompt version detection with Settings notice when prompt is outdated

2.0.2

  • Improved Product schema: correct brand type, numeric prices, shippingDetails, hasMerchantReturnPolicy
  • Validator catches invalid Product price formats, wrong brand @type, non-URL availability values

2.0.1

  • Confirmed compatibility with WordPress 7.0

2.0.0

  • Complete rewrite — new plugin name and slug (bluesoup-ai-auto-schema)
  • AI-powered JSON-LD generation with OpenAI (bring your own key)
  • Live validation with instant error highlighting
  • Per-page schema manager with add, edit, and delete
  • Business / site information settings injected into AI prompts
  • Pro: Global Schemas, Generate All Recommended, URL targeting
  • Clean output via wp_head — no theme modifications required