Documentation

Everything you need to install, configure, and get the most out of AI Schema Gen.

Getting Started

AI Schema Gen is an AI-powered schema markup plugin for WordPress. It automatically analyzes your page content and generates valid JSON-LD structured data — enabling rich results in Google such as star ratings, FAQ accordions, recipe cards, product prices, and more.

The plugin works as a WordPress admin tool that connects to the AI Schema Gen API. You need a free API key to use AI generation. The visual editor, code editor, and manual validation work without an API key.

What is JSON-LD? JSON-LD (JavaScript Object Notation for Linked Data) is Google's preferred format for structured data. It is added to the <head> of your page as a <script type="application/ld+json"> tag. AI Schema Gen handles all of this automatically.

Installation

From the WordPress Plugin Directory (recommended)

  1. 1In your WordPress admin go to Plugins > Add New
  2. 2Search for AI Schema Gen
  3. 3Click Install Now, then Activate
  4. 4AI Schema Gen will appear in your WordPress admin sidebar

Manual Installation

  1. 1Download the plugin zip from wordpress.org/plugins/ai-schema-gen
  2. 2In your WordPress admin go to Plugins > Add New > Upload Plugin
  3. 3Upload the zip file and click Install Now
  4. 4Click Activate Plugin

Minimum Requirements

  • • WordPress 5.8 or higher
  • • PHP 7.4 or higher
  • • MySQL 5.7 or higher / MariaDB 10.3 or higher

API Key Setup

AI Schema Gen uses an API key to connect your WordPress site to the AI Schema Gen backend. The free plan gives you 30 AI generations per month at no cost.

  1. 1Go to AI Schema Gen.com/register and create a free account
  2. 2After registering, your API key is shown on the dashboard. Copy it.
  3. 3In WordPress, go to AI Schema Gen > Settings
  4. 4Paste your API key into the API Key field and click Save Settings
  5. 5A green checkmark confirms the key is valid and connected
Your API key is shown once on registration. If you lose it, go to AI Schema Gen.com/dashboard — your active keys are listed under API Keys. You can generate new keys at any time.

Your First Schema

Once your API key is connected, generating schema is a single click.

  1. 1Open any post or page in the WordPress editor (Gutenberg or Classic Editor)
  2. 2Scroll down to the AI Schema Gen meta box below the editor
  3. 3Click Generate with AI
  4. 4The plugin sends your page title and content to the AI Schema Gen API, which classifies the content type and generates appropriate schema markup
  5. 5The generated schema appears in the editor. Review it — click Save to publish it to your page
  6. 6Optionally click Test with Google to open Google's Rich Results Test with your URL pre-filled
AI Schema Gen automatically detects your content type — Article, LocalBusiness, Product, FAQ, Recipe, Event, and more. If the auto-detected type is wrong, use the type selector to override it before generating.

Editors & Preview

The AI Schema Gen meta box has three tabs for working with your schema markup.

Visual Editor

Edit individual schema fields using a form interface. No JSON knowledge required. Fields are grouped by schema section (name, description, address, etc.) with labels and validation hints.

Code Editor

Edit the raw JSON-LD directly. Full syntax highlighting. Use this for advanced customisation, adding custom properties, or pasting schema from another source.

Live Preview

See a formatted preview of your schema as it will appear in the page source. Updates in real time as you edit in either the Visual or Code tab.

The Export button downloads your schema as a JSON file. The Import button accepts a JSON file — useful for copying schemas between posts or sites.

Validation

AI Schema Gen validates your schema markup automatically before saving.

Built-in Validation

The plugin checks your JSON-LD against schema.org specifications and Google's Rich Results requirements. Issues are shown inline with specific field-level messages — required fields missing, wrong data types, invalid formats, etc.

Google Rich Results Test

Click Test with Google inside the meta box to open Google's Rich Results Test with your page URL pre-filled. This runs Google's actual validator and shows whether your schema qualifies for rich search results.

The built-in validator catches structural issues immediately. Use Google's Rich Results Test after publishing to confirm the live schema passes Google's requirements (Google reads the schema from your live URL, so the page must be published and publicly accessible).

Schema Types

AI Schema Gen supports all 827+ schema types from schema.org. The AI automatically selects the most appropriate type based on your content. Common types:

Article / BlogPosting / NewsArticle

For blog posts, news articles, and editorial content

Product

For WooCommerce and e-commerce product pages

LocalBusiness

100+ subtypes: Restaurant, MedicalBusiness, GeneralContractor, Plumber, and more

FAQ

Adds FAQ accordion directly in Google search results

HowTo

Step-by-step guides and tutorials

Recipe

Cooking time, calories, ingredients — eligible for recipe cards

Event

Concerts, conferences, online events with date and location

Review / AggregateRating

Star ratings for products, services, and businesses

VideoObject

YouTube embeds and hosted videos

Course

Online courses and educational content

JobPosting

Job listings eligible for Google Jobs

Person / Organization

Author profiles and company pages

Need a type not listed? Use the Code Editor to write any schema.org type directly, or select from the full type list in the Visual Editor.

Entity Authority

Entity authority is the layer of schema that tells AI systems and search engines who you are — not just what your page is about. While standard schema types (Article, Product, FAQ) help earn rich results, entity authority signals are what get your brand cited by ChatGPT, Perplexity, and Google AI Overviews.

AI Schema Gen injects two key entity authority properties into your schema automatically: sameAs and knowsAbout. These are added to your Organisation and Person entities wherever they appear in generated schema.

Why this matters for AI search: Research shows 71% of pages cited by ChatGPT and 65% cited by Google AI Mode include structured data. Pages with complete entity profiles — sameAs links to verified external sources — are 3.4× more likely to appear in AI-generated answers than pages without them.

sameAs — Linking Your Entity to External Profiles

The sameAs property tells search engines and AI platforms that your Organisation or Person entity is the same as a known entity on an authoritative external source. This is how Google disambiguates your brand from others with similar names.

Add your sameAs URLs in AI Schema Gen > Settings > Entity Authority. AI Schema Gen will automatically include them in every piece of Organisation and Person schema it generates across your site.

Wikipedia

Highest authority signal. If your brand has a Wikipedia page, this is the most important sameAs URL to add.

en.wikipedia.org/wiki/YourBrand

Wikidata

Machine-readable knowledge base used directly by Google's Knowledge Graph. Add your Wikidata Q-identifier URL.

wikidata.org/wiki/Q12345

LinkedIn

Company page URL. Widely used by AI platforms to verify business identity and extract company details.

linkedin.com/company/yourbrand

Crunchbase

Particularly important for SaaS and tech companies. Crunchbase is a trusted entity source for AI systems.

crunchbase.com/organization/yourbrand

Facebook

Your official Facebook business page URL.

facebook.com/yourbrand

Twitter / X

Your verified brand account. Add the full profile URL.

x.com/yourbrand

knowsAbout — Declaring Your Areas of Expertise

The knowsAbout property declares the topics, industries, or domains your Organisation or Person has expertise in. AI platforms use this to decide whether your site is a credible source to cite on a given topic.

Add your topics in AI Schema Gen > Settings > Entity Authority > Areas of Expertise. Each topic can be a plain-text string or a URL pointing to a schema.org or Wikipedia topic page for maximum machine-readability.

Example output in generated schema

{
  "@type": "Organization",
  "name": "AI Schema Gen",
  "sameAs": [
    "https://en.wikipedia.org/wiki/AI_Schema_Gen",
    "https://linkedin.com/company/ai-schema-gen",
    "https://crunchbase.com/organization/ai-schema-gen"
  ],
  "knowsAbout": [
    "Schema markup",
    "Structured data",
    "WordPress SEO",
    "JSON-LD",
    "https://en.wikipedia.org/wiki/Schema.org"
  ]
}

Knowledge Graph Score

The AI Schema Gen dashboard shows a Knowledge Graph Score for your site — a 0–100 metric that measures how complete and verifiable your entity profile is. It factors in:

  • 1Number of sameAs URLs added (more verified sources = higher score)
  • 2Whether high-authority sources are included (Wikipedia and Wikidata carry the most weight)
  • 3Number of knowsAbout topics declared
  • 4Whether Organisation schema is present sitewide (not just on the homepage)
  • 5Consistency of entity name across all schema output on the site

A score above 70 is considered strong for AI search citation probability. The dashboard shows specific recommendations to improve your score.

Setting Up Your Organisation Entity

Your Organisation entity profile is the foundation of all entity authority on your site. Set it up once in plugin settings — AI Schema Gen uses it to enrich every piece of schema it generates.

  1. 1Go to AI Schema Gen > Settings > Organisation in your WordPress admin
  2. 2Enter your Organisation name exactly as it should appear in schema (consistent with your brand name across the web)
  3. 3Add your logo URL, website URL, and contact details
  4. 4Under Entity Authority, paste in your sameAs URLs (one per line)
  5. 5Under Areas of Expertise, add your knowsAbout topics
  6. 6Click Save Settings — AI Schema Gen will include this entity profile in all schema generated going forward
You do not need a Wikipedia page to benefit from entity authority. Even adding LinkedIn, Crunchbase, and your official social profiles as sameAs URLs significantly improves AI search citation probability — especially on YMYL (Your Money Your Life) topics where AI platforms apply stricter source verification.

Bulk Generation

Bulk generation is available on the Premium plan. It lets you generate schema for 100+ posts in a single operation from the AI Schema Gen SaaS dashboard.

  1. 1Log into your account at AI Schema Gen.com/dashboard
  2. 2Go to your site and click Bulk Generate
  3. 3Select the post types and posts to process
  4. 4Click Start Bulk Generation — the job is queued and processed in the background
  5. 5Progress is shown in real time. Individual post results (success/fail) are displayed when complete
Bulk generation calls your WordPress REST API directly from the AI Schema Gen backend using your API key. No wp-cron required — it works even if your site has no organic traffic or DISABLE_WP_CRON is set.

Analytics Dashboard

The AI Schema Gen dashboard at AI Schema Gen.com shows schema coverage across your site and rich result performance when Google Search Console is connected.

Schema Coverage

See which pages have active schema, which are missing coverage, and which have validation issues — across your entire site.

Rich Result Performance

Connect Google Search Console to import real click and impression data for pages with schema markup. Track CTR changes after adding structured data.

Competitor Analysis

Enter a competitor URL to see which schema types they use. Identify gaps in your own schema strategy. Available on Pro and Premium plans.

Generation History

Full log of every schema generated — post title, schema type, AI model, tokens used, and timestamp.

Integrations

Yoast SEO

Auto

AI Schema Gen automatically suppresses Yoast SEO's schema output when active. This prevents duplicate JSON-LD from appearing in your page source. Your Yoast SEO settings (titles, meta descriptions, sitemaps) are completely unaffected — only the schema output is managed by AI Schema Gen. No configuration required.

Rank Math

Auto

Same as Yoast SEO — Rank Math's structured data output is suppressed automatically when AI Schema Gen is active. All other Rank Math functionality continues to work normally.

All in One SEO (AIOSEO)

Auto

AIOSEO's schema output is suppressed automatically. No configuration required.

WooCommerce

Auto

When a post type is a WooCommerce product, AI Schema Gen automatically generates Product schema including name, description, price, availability, currency, and SKU pulled directly from WooCommerce product data.

Elementor

Widget

A Schema AI Status widget is available in the Elementor widget panel. Add it to any page to display whether schema is active, the schema type, and validation status — visible only in the Elementor editor, not on the front end.

ACF (Advanced Custom Fields)

Manual

Use the Code Editor to reference ACF field values in your schema. Custom field mapping for automatic ACF-to-schema property binding is available in future updates.

Plans & Limits

FeatureFreePro ($9.99/mo)Premium ($29/mo)
AI Generations / month303001,000
Schema types827+827+827+
Visual + Code editor
Built-in validation
Google Rich Results Test
Template library
Competitor URL analyses10 / mo100 / moUnlimited
Content gap analysis
Google Search Console
Multi-site1 site1 site5 sites (+$5/site)
Team seats3 (+$5/seat)
Bulk generation
Analytics dashboardBasicBasicFull
SupportForumEmailPriority

Each WordPress site requires its own API key. One API key cannot be used across multiple sites. See full pricing →

Troubleshooting

Schema not appearing in Google Rich Results Test

The test requires the page to be publicly accessible. Make sure the page is published (not draft) and not blocked by a password or maintenance mode. Also check that your page is not noindex — Google won't crawl noindexed pages.

API key shows as invalid

Double-check there are no leading or trailing spaces when pasting. Go to your AI Schema Gen dashboard and verify the key is active and not expired. If the issue persists, generate a new key from the dashboard.

Generate with AI button does nothing

Open your browser console (F12) and check for JavaScript errors. Also verify your API key is saved in Settings. If you see a CORS error, contact your hosting provider — some hosts block outbound API calls.

Duplicate schema in page source

If you have Yoast SEO, Rank Math, or AIOSEO installed alongside AI Schema Gen, their schema output is suppressed automatically since AI Schema Gen v1.1.2. If you still see duplicates, deactivate the other plugin's schema module manually in its settings as a fallback.

Wrong schema type generated

The AI classifies content based on the page title and body text. If the type is wrong, use the type selector in the meta box to override it, then click Generate again. For local business sites, fill in your business address and phone number in AI Schema Gen Settings so the AI has more context.

Bulk generation is stuck or not progressing

Since v1.1.1, bulk generation uses direct backend-to-WordPress REST API calls — no wp-cron needed. If it's stuck, check that your WordPress REST API is accessible externally. Test by visiting yourdomain.com/wp-json in a browser — it should return JSON.

FAQ

Does AI Schema Gen slow down my website?

No. JSON-LD schema is lightweight text added to the page <head>. The plugin admin interface uses React, but it is only loaded in the WordPress dashboard — never on your front end.

Can I edit the generated schema manually?

Yes. Use the Code Editor tab to edit the JSON-LD directly. Use the Visual Editor to change individual fields through a form interface. Any changes are saved when you click Save.

Is my content sent to OpenAI?

Your content is sent to the AI Schema Gen API (operated by Digital Storks Ltd), which then calls OpenAI to generate the schema. OpenAI does not use your content for model training. See our Privacy Policy at AI Schema Gen.com/privacy.

Does it work with page builders like Elementor or Divi?

Yes. AI Schema Gen reads the post content regardless of what page builder created it. The AI Schema Gen meta box is available on all post types in the WordPress dashboard.

Can I use one API key for multiple sites?

No. Each WordPress site requires its own API key. Once a key syncs with a site, it is bound to that site's URL. Generate a new key for each additional site from the AI Schema Gen dashboard.

What happens to my schema if I cancel my plan?

Your saved schema markup remains on your posts and pages — cancelling does not remove any schema from your site. You lose access to AI generation and premium features, but all existing schema continues to output in your pages.

How do I report a bug or request a feature?

Use the WordPress.org support forum at wordpress.org/support/plugin/ai-schema-gen/ or email support@aischemagen.com.

Ready to get started?

Create a free account and start generating schema in minutes.