Schema.org Markup for AI Visibility
What is Schema.org?#
Schema.org is a collaborative vocabulary created by Google, Microsoft, Yahoo, and Yandex that provides a shared set of types and properties for structuring data on the web. When you add Schema.org markup to your HTML, you are adding machine-readable annotations that explicitly describe what your content means. Instead of an AI model having to infer that a block of text is a product review or an FAQ answer, the structured data makes the meaning unambiguous. JSON-LD (JavaScript Object Notation for Linked Data) is the recommended format for adding Schema.org markup. It is a script tag embedded in your HTML head or body that does not affect the visual presentation but provides rich metadata to any system that reads it — including AI models, search engines, and voice assistants.
Key Schema Types for AI Visibility#
Not all Schema.org types are equally important for AI citation. The types that have the highest impact on AI visibility are those that provide clear, factual, attributable information. Organization schema establishes your entity and authority. FAQPage schema provides direct question-answer pairs that AI models love to quote. Article and TechArticle schemas help AI understand the structure and recency of your content. Product schema is critical for e-commerce sites wanting to appear in AI shopping recommendations.
- Organization — Establishes your brand identity, logo, contact info, and social profiles.
- FAQPage — Question-answer pairs that AI models directly cite in responses.
- Article / TechArticle — Marks content as editorial with author, date, and section structure.
- Product — Name, price, availability, reviews for AI commerce recommendations.
- HowTo — Step-by-step instructions that AI models structure into guided answers.
- BreadcrumbList — Helps AI understand your site hierarchy and navigation.
- LocalBusiness — Physical location, hours, and service area for local AI queries.
Implementation with JSON-LD#
Add Schema.org markup by embedding a JSON-LD script tag in your page's HTML. The example below shows Organization and FAQPage markup combined on a single page. Place these in your HTML <head> or at the end of <body>. Multiple JSON-LD blocks on the same page are perfectly valid and recommended when you have multiple entity types to describe.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Company",
"url": "https://example.com",
"logo": "https://example.com/logo.png",
"description": "Brief factual description of what your company does.",
"sameAs": [
"https://twitter.com/yourcompany",
"https://linkedin.com/company/yourcompany",
"https://github.com/yourcompany"
],
"contactPoint": {
"@type": "ContactPoint",
"email": "[email protected]",
"contactType": "customer service"
}
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What does your product do?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Our product provides domain intelligence and AI visibility scoring, scanning 62+ protocol endpoints to measure how well websites are prepared for AI discovery and citation."
}
},
{
"@type": "Question",
"name": "How much does it cost?",
"acceptedAnswer": {
"@type": "Answer",
"text": "We offer a free tier with 100 scans per month. Paid plans start at $99/month for 5,000 API calls with batch processing and historical data."
}
}
]
}
</script>You can include multiple JSON-LD script blocks on the same page. Each block describes a different entity type. This is the recommended approach.
Testing Your Markup#
After adding Schema.org markup, validate it using Google's Rich Results Test (search.google.com/test/rich-results) or the Schema.org Validator (validator.schema.org). These tools will catch syntax errors, missing required fields, and warn about deprecated properties. For AI-specific validation, use Citability's scanner which checks not just validity but also completeness and effectiveness for AI citation. Common validation errors include missing @context declarations, using incorrect property names (e.g., 'image' instead of 'logo' for Organization), and forgetting to escape special characters in JSON strings.
- 1Add your JSON-LD markup to the page.
- 2Open Google Rich Results Test and enter your page URL.
- 3Fix any errors shown in the validation results.
- 4Run a Citability scan to check AI-specific effectiveness.
- 5Monitor your AI citation rate in the Citability dashboard.
Frequently Asked Questions
No. JSON-LD is a small script tag (typically 1-3KB) that does not render visually or execute JavaScript. It has zero impact on Core Web Vitals or page performance.
FAQPage has the highest direct impact on AI citations because it provides explicit question-answer pairs that models can quote verbatim. Organization schema is a close second as it establishes entity authority.
Yes, but ensure your JSON-LD is included in the server-rendered HTML, not injected by client-side JavaScript. AI crawlers may not execute JavaScript. Use SSR or SSG frameworks like Next.js for best results.