AEO Optima Docs
Features

Schema Builder

Auto-generate JSON-LD structured data markup for Organization, Product, FAQPage, Article, HowTo, and more from your page content and brand facts.

Overview

The Schema Builder analyzes your page content and brand facts to generate JSON-LD structured data markup. Structured data helps AI models and search engines understand your content's meaning, increasing the likelihood of being cited accurately in AI-generated answers.

The builder produces ready-to-paste <script type="application/ld+json"> blocks for multiple Schema.org types, with each schema accompanied by a confidence score explaining why it was generated.

Supported Schema Types

Schema TypeWhen GeneratedConfidence
WebPageAlways generated for any URL.0.9
OrganizationWhen brand facts include company name, description, or founding information.0.85
FAQPageWhen page content contains two or more question-format headings.0.7
ArticleWhen page body text exceeds 300 words.0.6--0.8
HowToWhen page headings follow step-format patterns (e.g., "Step 1:", "1.").0.65
ProductWhen brand facts include product-category entries (name, price, description).0.6

How It Works

  1. Input — You provide a URL and the builder fetches available page content data (title, meta description, headings, body text, images) from your content optimizations. It also loads your project's brand facts.
  2. Analysis — The system evaluates the content against pattern rules for each schema type. For example, it counts question-format headings for FAQPage detection and measures word count for Article detection.
  3. Generation — Matching schema types are generated with all available fields populated. Brand facts enrich Organization and Product schemas with details like founding date, logo URL, contact email, and pricing.
  4. Output — All schemas are combined into a single JSON-LD block ready for embedding.

Schema Fields

Organization

Generated from brand facts. Supported fields:

  • name — From company_name, brand_name, or name brand facts.
  • url — From website or url brand facts.
  • description — From description or tagline brand facts.
  • logo — From logo or logo_url brand facts.
  • foundingDate — From founded or founded_year brand facts.
  • email — From email or contact_email brand facts.

Product

Generated when brand facts have a product category with at least two entries:

  • name — Product name.
  • description — Product description.
  • offers — Price and currency (extracted from price brand fact).

FAQPage

Generated when the page has two or more question-format headings (starting with what, who, why, how, etc.). Each heading becomes a Question entity.

Article

Generated when the page body exceeds 300 words. Includes headline, description, URL, and word count. Higher word counts produce higher confidence scores.

HowTo

Generated when headings follow step patterns like "Step 1:" or "1. Do something". Each step heading becomes a HowToStep.

How to Use

  1. Navigate to Schema Builder in the sidebar.
  2. Enter the URL you want to generate schema markup for, or select from your project's tracked pages.
  3. Review the generated schemas. Each one shows the schema type, confidence score, and the reason it was generated.
  4. Copy the combined JSON-LD output.
  5. Paste it into a <script type="application/ld+json"> tag in your page's <head> section.

Tips for Better Schema Output

  • Add comprehensive brand facts — The more facts you provide (company name, description, founding year, logo URL, pricing), the richer your Organization and Product schemas will be.
  • Structure your page content with question-format headings to trigger FAQPage schema generation.
  • Use numbered step headings for instructional content to trigger HowTo schema.
  • Write long-form content (800+ words) for the highest Article schema confidence.
  • Validate the generated JSON-LD using Google's Rich Results Test before deploying.

Plan Requirements

The Schema Builder is available on Pro-SME and above as part of the Content Intelligence feature set.

On this page