Documentation
Everything you need to install, configure, and get the most out of AISchemaGen.
Getting Started
AISchemaGen 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 AISchemaGen API. You need a free API key to use AI generation. The visual editor, code editor, and manual validation work without an API key.
<head> of your page as a <script type="application/ld+json"> tag. AISchemaGen handles all of this automatically.Installation
From the WordPress Plugin Directory (recommended)
- 1In your WordPress admin go to Plugins > Add New
- 2Search for AISchemaGen
- 3Click Install Now, then Activate
- 4AISchemaGen will appear in your WordPress admin sidebar
Manual Installation
- 1Download the plugin zip from wordpress.org/plugins/digitalstorks-schema-gen
- 2In your WordPress admin go to Plugins > Add New > Upload Plugin
- 3Upload the zip file and click Install Now
- 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
AISchemaGen uses an API key to connect your WordPress site to the AISchemaGen backend. The free plan gives you 30 AI generations per month at no cost.
- 1Go to aischemagen.com/register and create a free account
- 2After registering, your API key is shown on the dashboard. Copy it.
- 3In WordPress, go to AISchemaGen > Settings
- 4Paste your API key into the API Key field and click Save Settings
- 5A green checkmark confirms the key is valid and connected
Your First Schema
Once your API key is connected, generating schema is a single click.
- 1Open any post or page in the WordPress editor (Gutenberg or Classic Editor)
- 2Scroll down to the AISchemaGen meta box below the editor
- 3Click Generate with AI
- 4The plugin sends your page title and content to the AISchemaGen API, which classifies the content type and generates appropriate schema markup
- 5The generated schema appears in the editor. Review it — click Save to publish it to your page
- 6Optionally click Test with Google to open Google's Rich Results Test with your URL pre-filled
Editors & Preview
The AISchemaGen 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
AISchemaGen 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.
Schema Types
AISchemaGen 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.
Bulk Generation
Bulk generation is available on the Premium plan. It lets you generate schema for 100+ posts in a single operation from the AISchemaGen SaaS dashboard.
- 1Log into your account at aischemagen.com/dashboard
- 2Go to your site and click Bulk Generate
- 3Select the post types and posts to process
- 4Click Start Bulk Generation — the job is queued and processed in the background
- 5Progress is shown in real time. Individual post results (success/fail) are displayed when complete
Analytics Dashboard
The AISchemaGen dashboard at aischemagen.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
AutoAISchemaGen 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 AISchemaGen. No configuration required.
Rank Math
AutoSame as Yoast SEO — Rank Math's structured data output is suppressed automatically when AISchemaGen is active. All other Rank Math functionality continues to work normally.
All in One SEO (AIOSEO)
AutoAIOSEO's schema output is suppressed automatically. No configuration required.
WooCommerce
AutoWhen a post type is a WooCommerce product, AISchemaGen automatically generates Product schema including name, description, price, availability, currency, and SKU pulled directly from WooCommerce product data.
Elementor
WidgetA 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)
ManualUse 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
| Feature | Free | Pro ($9.99/mo) | Premium ($29/mo) |
|---|---|---|---|
| AI Generations / month | 30 | 300 | 1,000 |
| Schema types | 827+ | 827+ | 827+ |
| Visual + Code editor | ✓ | ✓ | ✓ |
| Built-in validation | ✓ | ✓ | ✓ |
| Google Rich Results Test | ✓ | ✓ | ✓ |
| Template library | ✓ | ✓ | ✓ |
| Competitor URL analyses | 10 / mo | 100 / mo | Unlimited |
| Content gap analysis | — | ✓ | ✓ |
| Google Search Console | — | ✓ | ✓ |
| Multi-site | 1 site | 1 site | 5 sites (+$5/site) |
| Team seats | — | — | 3 (+$5/seat) |
| Bulk generation | — | — | ✓ |
| Analytics dashboard | Basic | Basic | Full |
| Support | Forum | Priority |
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 AISchemaGen 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 AISchemaGen, their schema output is suppressed automatically since AISchemaGen 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 AISchemaGen 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 AISchemaGen 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 AISchemaGen 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 aischemagen.com/privacy.
Does it work with page builders like Elementor or Divi?
Yes. AISchemaGen reads the post content regardless of what page builder created it. The AISchemaGen 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 AISchemaGen 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/digitalstorks-schema-gen/ or email support@aischemagen.com.
Ready to get started?
Create a free account and start generating schema in minutes.