Description
BlueSoup AI Auto Schema is the easiest way to add correct, validated JSON-LD structured data to any WordPress page or post. The plugin reads your actual page content and uses AI to generate schema markup that’s accurate, complete, and ready for Google’s rich results — in one click.
Stop hand-coding JSON-LD. Stop second-guessing whether your markup is correct. Stop using generic templates that don’t reflect your real content. BlueSoup AI Auto Schema generates context-aware schema from your page and validates it instantly.
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.
Why structured data matters
Google uses JSON-LD schema markup to power rich results in search listings — star ratings, FAQ dropdowns, breadcrumb paths, product prices, event dates, recipe details, and more. Rich results generate significantly higher click-through rates than plain blue links.
Getting structured data right is technical and time-consuming. One missing field or wrong value can cause Google to ignore your schema entirely. BlueSoup AI Auto Schema handles the complexity so you don’t have to.
What makes this different
Most schema plugins give you a form to fill out. This plugin reads your page and generates the right markup from your real content — with live validation that catches errors before you save.
- AI reads your page — fetches live HTML, extracts signals (title, meta, existing JSON-LD, social links, phone, email, images), and generates schema from real data
- Live JSON-LD validator — green “Valid” badge or specific error messages as you type, before saving
- Business information injection — enter your name, address, phone, logo, and social profiles once in Settings; the AI uses those exact values in every schema it generates
- Clean output — injects
<script type="application/ld+json">directly into<head>with no front-end JavaScript, no page speed impact
Free features
- AI-powered JSON-LD generation — works with any OpenAI-compatible key (gpt-4.1-mini recommended)
- Live schema validation with instant, specific error messages
- Per-page schema manager — view, add, edit, and delete schemas on any page or post
- Multiple schemas per page — add Article + BreadcrumbList + FAQPage to a single post
- 20+ schema types supported (see full list below)
- Business / site information settings injected into every AI prompt
- Debug log for diagnosing AI calls
Supported schema types
Article, BlogPosting, NewsArticle, Product, Offer, FAQPage, HowTo, Recipe, Organization, LocalBusiness, Person, WebSite, WebPage, BreadcrumbList, SiteNavigationElement, Event, VideoObject, ImageObject, Review, and any custom Schema.org type.
Pro features
- Global Schemas — inject Organization, WebSite, or any schema across every page of your site with one click. No more adding the same Organization schema to every page manually.
- ✨ Generate All Recommended — one click analyses a page and generates all appropriate schema types automatically (Article + BreadcrumbList + FAQPage in a single AI call)
- URL Targeting — attach schemas to any URL, including pages not managed by WordPress posts or pages
Who is this for?
- SEO professionals who manage structured data across many client sites and need a reliable, fast workflow
- WordPress developers who want to implement correct schema without maintaining custom code
- Business owners who want rich results (star ratings, FAQs, breadcrumbs) but don’t want to learn JSON-LD
- Bloggers and publishers who want Article and BreadcrumbList schema on every post without a plugin conflict minefield
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. 
Schema editor — edit JSON-LD with live validation, a “Valid” indicator, and one-click AI generation. 
Settings — enter business details once and the AI uses them in every schema it generates. 
Get Pro — feature comparison showing free vs Pro capabilities.
Installation
- Install through the WordPress Plugins screen (search “BlueSoup AI Auto Schema”) or upload the zip via Upload Plugin.
- Activate the plugin.
- Go to BlueSoup AI Auto Schema in the admin menu.
- Open Settings — enter your business name, address, phone, logo URL, and OpenAI API key.
- Go to Schema Manager, choose a page or post, and click Load Schemas.
- 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.
-
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 page might have BreadcrumbList + Article + FAQPage all at once. -
Will this conflict with Yoast SEO, RankMath, or All in One SEO?
-
Generally no — most SEO plugins output their own schema separately and BlueSoup AI Auto Schema adds its own blocks alongside them. If you notice duplicates for a specific type (e.g., both plugins output an Organization schema), simply disable that type in one of the plugins.
-
What schema types are supported?
-
Article, BlogPosting, NewsArticle, Product (with Offer, shippingDetails, hasMerchantReturnPolicy), FAQPage, HowTo, Recipe, Organization, LocalBusiness, Person, WebSite, WebPage, BreadcrumbList, SiteNavigationElement, Event, VideoObject, ImageObject, Review, and more. If a Schema.org type exists, you can use it — just type the @type manually.
-
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.
-
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.
-
Is there a way to output schema without the plugin editing my theme?
-
Yes — that is exactly how this plugin works. Schema is injected via a
wp_headhook. No theme file editing is required.
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
Translate “BlueSoup AI Auto Schema” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.5
- Fixed: Plugin icon and banner image now appear correctly in the WordPress Updates screen and plugin detail modal
2.0.4
- Product schema post-processor: auto-fixes brand @type from “Organization” to “Brand”, injects logo URL from Settings as image fallback when no product image is found on the page, and sets priceSpecification.minPrice to 0 when no price can be determined (e.g. calendar-based or dynamic pricing)
- Prompt version detection: Settings tab now shows a notice when the saved AI prompt pre-dates recent quality improvements, with a direct link to reset to the current default
- Prompt version is now tracked in settings — the notice clears automatically once Settings are saved
2.0.2
- Improved Product schema quality: AI now generates correct brand type (Brand not Organization), numeric price values, shippingDetails, and hasMerchantReturnPolicy to clear Google Search Console merchant listing warnings
- Validator now catches invalid Product price formats, wrong brand @type, and non-URL availability values with clear fix guidance
- AI prompts updated to never fabricate aggregateRating or review data when none exists on the page
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