How to add JSON-LD schema to your website.

JSON-LD structured data is the single most important thing you can add to your website for AI search visibility. It tells ChatGPT, Perplexity, Google AI Overviews, and Gemini exactly what your business does, what you sell, and how to describe you. Without it, AI search engines have to guess — and they usually skip you entirely.

What is JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) is a way to embed machine-readable information about your website directly into your HTML. It sits inside a script tag and is invisible to visitors — but AI search engines and Google read it to understand your content.

Think of it like a business card for machines. When Perplexity crawls your site, it reads your JSON-LD to learn your company name, what you sell, your contact info, and your FAQ answers. Without it, the AI has to parse your entire page and hope it gets the right interpretation.

The 4 schema types every website needs

1. Organization Schema

This tells AI engines who you are — your company name, logo, website, contact info, and social profiles. Every website should have this on the homepage.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Company Name",
  "url": "https://yourwebsite.com",
  "logo": "https://yourwebsite.com/logo.png",
  "email": "hello@yourwebsite.com",
  "sameAs": [
    "https://twitter.com/yourcompany",
    "https://linkedin.com/company/yourcompany"
  ]
}
</script>

Paste this in your head tag on your homepage. Replace the placeholder values with your real information.

2. Product Schema

If you sell anything — products, services, subscriptions — add Product schema to every product page. This is what gets you into Google AI Overviews shopping results and AI-powered product recommendations.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Your Product Name",
  "description": "One sentence describing your product.",
  "image": "https://yourwebsite.com/product.jpg",
  "offers": {
    "@type": "Offer",
    "price": "29.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://yourwebsite.com/product"
  }
}
</script>

3. FAQ Schema

FAQ schema is one of the highest-impact additions for AI search. When someone asks ChatGPT a question that matches your FAQ, it can pull your answer directly. This is how businesses get cited in AI-generated responses.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What does your company do?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We help businesses optimize..."
      }
    },
    {
      "@type": "Question",
      "name": "How much does it cost?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Plans start at $29/month..."
      }
    }
  ]
}
</script>

Add 5-10 questions that your customers actually ask. Write clear, factual answers in 2-3 sentences. Avoid marketing language — AI engines prefer direct, informative responses.

4. Article Schema

For blog posts and content pages, Article schema tells AI engines when the content was published and last updated. This is critical because AI search engines heavily weight content freshness — undated content gets deprioritized.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title",
  "datePublished": "2026-06-27",
  "dateModified": "2026-06-27",
  "author": {
    "@type": "Organization",
    "name": "Your Company Name"
  }
}
</script>

Where to put the code

Every JSON-LD block goes inside a script tag with type "application/ld+json" in your HTML. You can place it in the head or at the end of body — both work. Most developers put it in the head.

WordPress: Use a plugin like Rank Math or Yoast, or paste the code into your theme header file.

Shopify: Add the code to your theme.liquid file inside the head tag.

Next.js / React: Create a component that renders the script tag with the JSON content.

Plain HTML: Paste it directly into your HTML file.

How to verify it works

After adding your JSON-LD, verify it's valid:

• Open your page in a browser and view source — search for "application/ld+json" to confirm the code is there.
• Use Google's Rich Results Test to validate the schema syntax.
• Run an AI search optimization audit to see your GEO score improve — our audit checks schema coverage as one of its 18+ signals.

Common mistakes to avoid

• Missing datePublished/dateModified: AI engines assume undated content is old and skip it.
• Placeholder text: Don't leave "Your Company Name" in the schema. Use your actual business information.
• Duplicate schema: Don't add the same schema type twice on one page. One Organization per homepage, one Product per product page.
• Invalid JSON: A missing comma or bracket breaks the entire block. Always validate after pasting.
• No FAQ schema: This is the most commonly missed schema type, and the one with the highest impact on AI citations.

The bottom line

Adding JSON-LD schema takes 30 minutes and is the single highest-impact change you can make for AI search visibility. Sites with comprehensive structured data get cited 3-5x more often by AI search engines than sites without. If you do one thing from this guide, add Organization and FAQ schema to your homepage today.