JSON-LD Generator

Structured Data for AI Search and Entity Understanding GUIDANCE CHECKED AUGUST 2026

Reviewed for current guidance: This article was checked against Google Search Central and Schema.org documentation in August 2026. Valid markup can make a page eligible for a feature; Google does not guarantee a rich result or ranking.

Structured data can give search systems machine-readable context about a page, its entities and their relationships. It is one input among many: accurate markup does not guarantee rankings, citations, inclusion or answers in any AI search product.

πŸ”Ž Practical checks for structured data

Use the workspace to review whether your JSON-LD matches the page content before publishing:

πŸ”¬ Search-style Preview Review an illustrative search-style preview before publishing; actual appearance is decided by the platform
πŸ“Š Quality guidance Quality guidance flags common structural and content issues; it is not an eligibility guarantee
πŸ”— @graph Mode Link entities with @id references for clearer entity context
πŸ€– Entity review Review whether entities and relationships are represented accurately

1. Entities vs Keywords

Neural networks think in objects (Entities), not words. When you write about "Apple," AI must instantly understand: is this a fruit or a tech giant? JSON-LD is the only way to directly tell AI which entity in Wikipedia or Wikidata your content relates to.

πŸ•ΈοΈ Knowledge Graph Visualization

[Your Article]
    β”‚
    β”œβ”€β”€ IS_ABOUT β†’ [Search Engine Optimization]
    β”‚       └── sameAs: wikidata.org/wiki/Q180711
    β”‚
    β”œβ”€β”€ MENTIONS β†’ [OpenAI]
    β”‚       └── sameAs: wikidata.org/wiki/Q21708200
    β”‚
    └── IS_BASED_ON β†’ [Original Research]
            └── url: research.example.com/study-2026

This is how AI sees your content when properly marked up.

See the Difference: Before & After AI-Optimized Schema

❌ Without AI Schema
example.com β€Ί article
Your Article Title
Your article content without clear entity relationships...
0%
AI Citation Rate
βœ… With AI Schema
AI
AI Answer Engine
Cited as authoritative source
Your Article Title
Your article with clear entity relationships and original research...
πŸ€– AI Confidence: High
βœ“ Entities verified via Wikidata
βœ“ Original research cited
βœ“ Author expertise confirmed
Varies
AI Citation Rate

2. Search visibility and machine-readable context

Structured data complements, rather than replaces, sound SEO fundamentals such as useful visible content, crawlability, accessibility and clear page structure:

Function Traditional SEO Structured-data workflow
Goal Ranking for keywords Describe entities accurately; inclusion is not guaranteed
Primary Tool Title/H1 tags, keyword density Schema.org properties that match visible content
Logic Link to page Make page meaning easier to interpret
Measurement Organic traffic, rankings Validation results, crawl/indexing signals and user outcomes
Content Structure For humans (readability) For people first, with accurate entity relationships
Validation Google Rich Results Test Official testing plus our field guidance

3. Properties 'about' and 'mentions'

These properties are useful when they accurately describe visible page content; they are not secret ranking or AI-visibility signals.

PRO STRATEGY

Use Identifiers (IDs)

Don't add identifiers merely for appearance. Use sameAs only for a reliable, relevant identity reference, and ensure it matches the visible entity. Our generator helps you review the structure.

⚠️ Critical: The isBasedOn Property

isBasedOn can document a genuine relationship to original research or another source. It may provide useful context, but it does not prove authorship, boost E-E-A-T automatically or guarantee a search outcome. Our quality guidance helps you review whether the property is appropriate.

4. mainEntityOfPage: Removing Noise

An average webpage has lots of "noise": footer, sidebar, related articles. The mainEntityOfPage property clearly tells the neural network: "Ignore everything else, here's the main essence to use for answering the user."

πŸ€– Why AI Chooses Your Content Over Others

When a search or answer system evaluates a page, many signals may matter. Use this checklist to review your implementation:

  • Citability: AI looks for verifiable facts. Proper schema with sameAs references makes your content more citable.
  • Structure: mainEntityOfPage identifies the primary page entity and helps systems interpret the document structure.
  • Entity Density: Pages with clear entity relationships get prioritized for complex queries.
  • Originality Signal: isBasedOn properties indicate original research, not derivative content.
  • Context Completeness: Proper use of about and mentions provides full topic context.
  • Quality guidance: Review whether the schema accurately describes the page.

5. Complete entity-aware JSON-LD example with @graph

Here is an illustrative example of linked entities. It is not a recipe for citations, rankings or inclusion in any particular product.


{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "@id": "https://example.com/blog/future-seo-2026#article",
      "headline": "The Future of SEO in 2026: AEO Dominance",
      "description": "How Answer Engine Optimization is replacing traditional SEO strategies for AI-first search.",
      "about": [
        {
          "@type": "Thing",
          "@id": "https://example.com/entities/seo#thing",
          "name": "Search Engine Optimization",
          "sameAs": "https://www.wikidata.org/wiki/Q180711",
          "description": "Process of improving website visibility in search engines"
        },
        {
          "@type": "Thing",
          "@id": "https://example.com/entities/ai#thing",
          "name": "Artificial Intelligence",
          "sameAs": "https://www.wikidata.org/wiki/Q11660"
        }
      ],
      "mentions": [
        {
          "@type": "Organization",
          "@id": "https://example.com/entities/openai#organization",
          "name": "OpenAI",
          "sameAs": "https://www.wikidata.org/wiki/Q21708200",
          "description": "AI research laboratory"
        },
        {
          "@type": "Product",
          "name": "Google SGE",
          "description": "Google's Search Generative Experience"
        },
        {
          "@type": "SoftwareApplication",
          "name": "Perplexity AI",
          "description": "AI-powered answer engine"
        }
      ],
      "isBasedOn": [
        {
          "@type": "CreativeWork",
          "name": "2026 Search Industry Report",
          "url": "https://research.example.com/search-trends-2026"
        },
        {
          "@type": "Dataset",
          "name": "AI Search Adoption Metrics",
          "url": "https://data.example.com/ai-search-stats"
        }
      ],
      "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://example.com/blog/future-seo-2026"
      },
      "author": {
        "@type": "Person",
        "@id": "https://example.com/author/alex#person",
        "name": "Alex Johnson",
        "url": "https://example.com/author/alex",
        "knowsAbout": ["SEO", "AI", "Search Algorithms"],
        "sameAs": ["https://orcid.org/0000-0000-0000"]
      }
    }
  ]
}

Review warnings and complete applicable fields - The generator flags common issues; verify the published page with official tools.

🎯 How to review entity interpretation

Copy your generated JSON-LD and paste it into ChatGPT or Claude with the question: "What entities and relationships do you see in this code?" Use the result as an exploratory check, not as evidence of ranking eligibility. To create a reviewed draft with schema preview and quality guidance, use our Generator.

πŸš€ Ready to publish clearer structured data?

Give search systems accurate, machine-readable context without overclaiming what markup can do. Our tool helps you review 'about', 'mentions' and 'isBasedOn' when they genuinely describe the page.

Generator

Free β€’ No registration β€’ Field guidance β€’ Schema Preview β€’ @graph Mode

Frequently Asked Questions

What is AEO (Answer Engine Optimization) in 2026?

Structured data is a machine-readable description of page content and entities. It can support interpretation when it accurately matches the visible page, but no markup guarantees inclusion, citations, rankings or answers in an AI search product.

How do 'about' and 'mentions' properties help with AI in 2026?

The 'about' property can describe the main topic, while 'mentions' can describe entities discussed on the page. Use them only when they accurately reflect visible content; they are not an AI visibility guarantee.

What is the 'isBasedOn' property and why is it critical in 2026?

isBasedOn can document a relationship to original research or another source. It may provide context when accurate, but it does not prove originality or guarantee ranking, trust or visibility outcomes. Our generator helps you review whether the property is appropriate.

What's new for AI schema optimization in 2026?

Current practice: use @graph and identifiers when they clarify genuine entity relationships, keep markup aligned with visible content, and validate the published page with official tools. Platform features and eligibility can change; no outcome is guaranteed.

πŸ’Ž Key Takeaways for AI Optimization in 2026

  • βœ… Use 'about' and 'mentions' to define entity relationships
  • βœ… Add 'isBasedOn' only when it documents a genuine source relationship
  • βœ… Use 'mainEntityOfPage' to remove noise for AI parsing
  • βœ… Include Wikidata references via 'sameAs' for entity verification
  • βœ… Use @graph when it makes entity relationships clearer
  • βœ… Test with SERP preview before publishing
  • βœ… Aim for quality guidance in our generator
  • βœ… Use AI chat review only as exploratory feedback, not official validation
  • βœ… Monitor documented search and user signals instead of assuming AI citations
  • βœ… Recheck important published pages after meaningful content or template changes

Use the generator's quality guidance to review implementation details, then verify the published page with current official documentation and testing tools.

Related Articles

Next step

Use accurate, visible facts and linked entities; validate the page instead of relying on AI-search guarantees.

Generator Audit a live URL first