---
title: "Schema markup for AI: the home page | Agent Ready Checklist"
description: "Schema markup for AI: what to put on the home page. The Organization block, sameAs, contact details and type breadth, with the four Ora checks that grade them."
canonical: https://agentreadychecklist.com/guides/schema-markup-for-ai
site: "Agent Ready Checklist"
last_updated: 2026-11-05
date: 2026-11-05
section: "Guides"
---

# Schema markup for AI: the home page | Agent Ready Checklist

> Schema markup for AI: what to put on the home page. The Organization block, sameAs, contact details and type breadth, with the four Ora checks that grade them.

Source: https://agentreadychecklist.com/guides/schema-markup-for-ai
Site: Agent Ready Checklist
Last reviewed: 2026-11-05
Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search)
Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free).

# Schema markup for AI: what to put on the home page

Put JSON-LD on the home page first: an Organization block with a name, a URL, sameAs links and contact details, then repeat the key facts in visible text. The evidence is thin, since Vercel's study measured no gain from JSON-LD, yet Ora grades four things on it and 47.4% of crawled home pages carry JSON-LD that parses.

## Before you start

You need to edit the head or body of the home page template, and the facts you want agents to repeat: the name, what you sell, where you are listed. This is [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/), a SHOULD for every site. Structured data means machine-readable statements about the page, and JSON-LD is the form of it that sits in one script tag.

## Steps

1.  **Add an Organization block to the home page.** One script tag, valid JSON, with the facts that must be right.
    
    ```html
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Organization",
      "name": "Example Co",
      "url": "https://example.com/",
      "description": "Example Co sells invoicing software for small firms.",
      "sameAs": [
        "https://github.com/example-co",
        "https://www.linkedin.com/company/example-co"
      ],
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@example.com"
      }
    }
    </script>
    ```
    
2.  **Link your official profiles with sameAs.** Ora's json-ld-entity-linking check looks for sameAs links to profiles such as GitHub, LinkedIn and app stores, so that an agent can confirm every mention of you is you.
3.  **Add contact details and an address.** Ora's org-schema-completeness check looks for them in the structured data, and describes them as how an agent verifies you are a real business.
4.  **Mark up the other kinds of content you really have.** Ora's schema-type-breadth check rewards FAQs, services, events and videos marked up with schema.org. Mark up only what the page shows. [The row](https://agentreadychecklist.com/checklist/ar-read-08/) lists Review or AggregateRating markup the page does not support as a common mistake.
5.  **Repeat the facts in visible text.** The spec says markdown converters may omit script blocks, and Cloudflare's converter keeps JSON-LD only as a fenced block at the end of the document, so the price, the plan names and the contact line belong in the body too.
6.  **Check that it parses.** The kit extracts every block and prints the types.
    
    ```bash
    curl -fsSL https://agentreadychecklist.com/kit/verify.sh | bash -s -- https://example.com --only=json-ld
    ```
    

## What Ora grades

| Ora check | Layer, points, tier | Looks at |
| --- | --- | --- |
| json-ld | Access, 4 points, required | The completeness of the home page JSON-LD. |
| json-ld-entity-linking | Access, 2 points, recommended | sameAs links from the structured data to official profiles. |
| org-schema-completeness | Access, 2 points, recommended | Company details such as contact and address in the structured data. |
| schema-type-breadth | Access, 2 points, recommended | How many kinds of content are marked up with schema.org. |

Only json-ld is matched to AR-READ-08 on [the crosswalk](https://agentreadychecklist.com/checklist/ora-checks/), because the row names JSON-LD and the other three ask for more: sameAs links, organization details and type breadth. The sameAs check is listed there as related and stricter, and the other two are not matched to any row. Together the four carry 10 points of Ora's score.

## What the evidence shows

-   The spec says agents can parse facts from the block but markdown converters may omit script blocks, so critical facts belong in visible text too.primary source: [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md), read 2026-11-04
-   The Vercel guide says the study did not measure an improvement in accuracy or completion from JSON-LD.primary source: [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents), read 2026-11-04
-   Cloudflare Markdown for Agents keeps JSON-LD as a fenced json block at the end of the converted document.primary source: [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/), read 2026-11-04
-   JSON-LD is not a ranking or retrieval switch; it changed nothing in the 19-configuration experiment.from the row, [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/)
-   Does not replace the same facts in the body text.from the row, [AR-READ-08](https://agentreadychecklist.com/checklist/ar-read-08/)

So the case for the markup is identity and consistency, not retrieval. A site that wants agents to describe it correctly gives them a block to quote, and checks that it agrees with the page.

## In the crawl

Home page carries JSON-LD that parses

47.4% overall

2,793 of 5,890 reachable sites in the Tranco top 10,000 on which the check ran, crawl of 2026-11-04. Left is ranks 1 to 1,000.

Numbers behind the chart

| Rate | 1 to 1,000 | 1,001 to 2,000 | 2,001 to 3,000 | 3,001 to 4,000 | 4,001 to 5,000 | 5,001 to 6,000 | 6,001 to 7,000 | 7,001 to 8,000 | 8,001 to 9,000 | 9,001 to 10,000 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Home page carries JSON-LD that parses | 49% | 46% | 51% | 50% | 42% | 46% | 49% | 52% | 45% | 44% |

## On your platform

15 of the 19 platforms with a recipe for this row have a direct one: [Next.js](https://agentreadychecklist.com/platforms/nextjs-app-router/#ar-read-08), [Astro](https://agentreadychecklist.com/platforms/astro/#ar-read-08), [Nuxt](https://agentreadychecklist.com/platforms/nuxt/#ar-read-08), [SvelteKit](https://agentreadychecklist.com/platforms/sveltekit/#ar-read-08), [Remix and React Router](https://agentreadychecklist.com/platforms/remix-react-router/#ar-read-08), [Static hosting](https://agentreadychecklist.com/platforms/static-hosting/#ar-read-08), [WordPress, Elementor](https://agentreadychecklist.com/platforms/wordpress-elementor/#ar-read-08), [Shopify](https://agentreadychecklist.com/platforms/shopify/#ar-read-08), [Webflow](https://agentreadychecklist.com/platforms/webflow/#ar-read-08), [Framer](https://agentreadychecklist.com/platforms/framer/#ar-read-08), [Wix](https://agentreadychecklist.com/platforms/wix/#ar-read-08), [Squarespace](https://agentreadychecklist.com/platforms/squarespace/#ar-read-08), [HubSpot CMS](https://agentreadychecklist.com/platforms/hubspot-cms/#ar-read-08), [Docusaurus](https://agentreadychecklist.com/platforms/docusaurus/#ar-read-08), [Mintlify](https://agentreadychecklist.com/platforms/mintlify/#ar-read-08).

## Sources

-   [github.com/agentready-org/standard/blob/main/spec/spec.md](https://github.com/agentready-org/standard/blob/main/spec/spec.md)read 2026-11-04
-   [vercel.com/kb/guide/make-your-site-readable-by-ai-agents](https://vercel.com/kb/guide/make-your-site-readable-by-ai-agents)read 2026-11-04
-   [developers.cloudflare.com/fundamentals/reference/markdown-for-agents/](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/)read 2026-11-04
-   [ora.ai/api/checks, contract 1.38.0](https://ora.ai/api/checks?utm_source=agentreadychecklist.com&utm_medium=referral&utm_campaign=guide)read 2026-11-05
-   [schema.org/sameAs](https://schema.org/sameAs)read 2026-11-05
-   [schema.org/ContactPoint](https://schema.org/ContactPoint)read 2026-11-05

Edition

Data

2026-11-04

Reviewed

2026-11-05

Spec

AgentReady v2.0, 273d2d7

Crawl

13,071 rows, 2026-11-04

Ora

132 checks, contract 1.38.0, 2026-11-05

Verify with Ora

The scanner this site recommends for the whole checklist. 132 checks, a score out of 100, no account.

`npx ax@0.10 audit <url> --min-score <n>`

[Why Ora, and its limits](https://agentreadychecklist.com/verify-with-ora/)

Method

-   [How rows, commands and rates are made](https://agentreadychecklist.com/method/)
-   [How an Ora check is matched to a row](https://agentreadychecklist.com/checklist/ora-checks/)
-   [Pass rates by rank band](https://agentreadychecklist.com/data/by-rank/)

Sources and read dates sit at the foot of the page.

Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.