Analyzer Compare Website Audit Scan History
Scoring Pillars
Structural Integrity AI Extractability Content Clarity Authority & Trust
Contact
Schema type
Choose the type that best matches your page. You can generate multiple schemas and combine them.
Generated JSON-LD

    

What is JSON-LD and why does it matter for AI?

JSON-LD is a small block of code that you add to the <head> of your page. It doesn't change how the page looks - it adds a layer of structured, machine-readable information that tells AI systems and search engines exactly what your content is, who created it, and what it's about.

Without JSON-LD, a large language model reading your page has to infer everything from your HTML structure and prose. With JSON-LD, you give it explicit answers: "This is a FAQPage. Here are the questions. Here are the answers." The model doesn't have to guess - and that dramatically improves extraction accuracy.

JSON-LD schema is the single highest-impact optimization in the AI Extractability pillar - the highest-weighted pillar at 35% of your total LLM Visibility Score.

It is also the only optimization that simultaneously improves your Google rich results eligibility, your AI citation likelihood, and your overall structured data coverage - making it one of the highest-ROI technical SEO actions available.

Which schema is right for your page?

FAQPage +10 pts
Best for: pages that answer questions
The highest-scoring schema in the Analyzer. FAQPage explicitly structures your content as question-answer pairs - exactly the format LLMs use when generating responses. When a user asks an AI a question, it looks for FAQPage schema first. Any page that answers "What is X?", "How does X work?" or "What are the benefits of X?" is a candidate.
Any page that contains questions and answers - service pages, product pages, blog posts with Q&A sections.
HowTo +8 pts
Best for: step-by-step guides and tutorials
HowTo schema breaks down a process into numbered steps that LLMs can extract and present sequentially. When someone asks an AI "How do I do X?", it preferentially sources from pages with HowTo schema. Ideal for setup guides, installation instructions, recipes, and any page that walks the reader through a process.
Tutorial pages, setup guides, recipe pages, any page that walks through a step-by-step process.
Article / BlogPosting +5 pts
Best for: blog posts, news articles, editorial content
Article schema tells LLMs that this page is a self-contained piece of authored content. It carries authorship, publication date, and modification date - all signals that AI systems use to assess freshness and credibility. Use BlogPosting for informal blog content and NewsArticle for time-sensitive journalism.
Individual blog posts, news articles, and editorial pages only. Do not add to homepages or category pages.
Organization +5 pts
Best for: company homepages and about pages
Organization schema establishes your entity on the web - your official name, URL, logo, social profiles, and contact information. LLMs use this to confirm that a real, identifiable organization is behind the content. It is also used by Google's Knowledge Panel and by AI systems when building entity graphs.
Homepage and Contact page. Add once per site - not on every page.
Person +5 pts
Best for: personal sites, author pages, portfolios
Person schema identifies an individual author or creator. It links a name to a professional role, social profiles, and contact information - making the person a verifiable entity in the eyes of AI systems. Particularly valuable for freelancers, consultants, journalists, and anyone who publishes content under their own name.
Homepage of a personal site, author bio page, or portfolio. One per site.
Product +6 pts
Best for: e-commerce product pages
Product schema provides structured product information - name, description, price, availability, and reviews - in a format that AI systems and Google Shopping can parse directly. When someone asks an AI to compare products or find the best option in a category, Product schema makes your listing far more likely to be included.
Individual product pages only. One schema per product - not on category or listing pages.
BreadcrumbList +5 pts
Best for: any page - especially deep in a site hierarchy
BreadcrumbList is one of the easiest schemas to implement and one of the most universally applicable. It tells AI systems where this page sits within your site - Home → Category → Subcategory → Page. This context helps LLMs understand the topical hierarchy of your content and improves attribution accuracy.
Every page that is more than one level deep in your site hierarchy. Can be added site-wide.
LocalBusiness +5 pts
Best for: businesses with a physical location
LocalBusiness schema provides location-specific information - address, phone number, opening hours, and geographic coordinates. AI assistants that answer local queries ("best coffee shop near me", "plumber in Athens") use this data directly. Without it, your business is invisible to location-aware AI responses.
Homepage and Contact page. If you have multiple locations, add a separate schema for each location page.

How JSON-LD changes the way AI reads your content

Removes ambiguity
LLMs reading raw HTML must infer meaning from context. JSON-LD removes that inference step entirely - "this is a question", "this is the answer", "this is the author". Less ambiguity means more accurate extraction.
Increases citation confidence
When an AI system is deciding whether to cite your page, structured data acts as a credibility signal. A page with FAQPage schema is more likely to be cited for Q&A content than an equivalent page without it.
Works alongside other signals
JSON-LD doesn't replace good content - it amplifies it. A well-written page with schema markup performs significantly better than the same page without it. The two signals reinforce each other.
Understood by every major AI system
Schema.org vocabulary - which JSON-LD uses - is maintained by Google, Microsoft, Yahoo and Yandex. Every major AI system is trained to recognize and prioritize it. It is the most universally understood structured data format on the web.

Check your current JSON-LD score

Run a free LLM visibility analysis to see how your structured data affects your AI Extractability score.

Run a free analysis ↗

Common questions

What is JSON-LD schema markup?
JSON-LD is a way to add structured data to your web pages using a script tag in the HTML head. It tells search engines and AI systems exactly what your content is about - the type of page, who created it, what it contains, and how it relates to other entities on the web.
Does JSON-LD affect my Google ranking?
JSON-LD can enable rich results in Google Search (FAQ dropdowns, How-to steps, product ratings) which improve click-through rates. It also helps Google understand your content more accurately. For AI systems like ChatGPT and Claude, structured data significantly improves how reliably your content is extracted and cited.
Which schema type should I use?
Choose the schema that best matches your page type. FAQPage for pages with questions and answers, HowTo for step-by-step guides, Article for blog posts and news, Organization for your company homepage, Product for e-commerce pages, and BreadcrumbList for any page to show its position in your site hierarchy.
Can I add multiple schema types to one page?
Yes - and it is recommended. For example, a blog post can have both Article and BreadcrumbList schemas. Each schema goes in a separate script tag, or you can use an array in a single tag. The hey-eye Analyzer awards bonus points for pages with multiple schema types.
Where do I add the generated JSON-LD?
Paste the generated code inside the <head> section of your HTML page, before the closing </head> tag. Most CMS platforms (WordPress, Webflow, Shopify) have a field for custom head code where you can paste it directly.
How does this affect my LLM Visibility Score?
The hey-eye Analyzer checks for JSON-LD schema as part of the AI Extractability pillar - the highest-weighted pillar at 35% of the total score. FAQPage earns +10 points, HowTo +8, Product +6, and most other schemas +5. Having multiple schemas earns an additional +3 bonus.