Mar 202611 min

Structured Data Essentials: Building JSON-LD Schema Markup

Learn the fundamentals of structured data. Discover how to construct JSON-LD schema for Organization, Article, Person, FAQ, and Breadcrumbs.

SEOStructured DataSchema MarkupTechnical SEO

Structured Data Essentials: Building JSON-LD Schema Markup

Chapter 16 of 37 · Complete SEO/GEO Series

Previous: International SEO & Hreflang · Next: E-commerce Rich Results Schema →

Search engines are highly sophisticated, but they still struggle to interpret raw text context.

If you list a name, an address, and a phone number on your page, a search engine can guess it represents a business contact, but it cannot be certain. Structured data solves this ambiguity. By adding standardized code markup to your pages, you tell search bots exactly what your content elements represent.

Understanding structured data essentials is about implementing JSON-LD schema to earn rich results in traditional search and define entity nodes in AI knowledge graphs.

Here are the primary schema types, how to construct JSON-LD templates, and how to validate your code.

Organization Schema

Organization schema establishes your business entity's identity, connecting your domain to your official name, logo, social profiles, and parent entities.

JSON-LD Template:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://yoursite.com/#organization",
  "name": "Nabil's Tech Labs",
  "url": "https://yoursite.com",
  "logo": "https://yoursite.com/images/logo.png",
  "sameAs": [
    "https://twitter.com/nabilthange",
    "https://github.com/nabilthange",
    "https://linkedin.com/in/nabilthange"
  ]
}

This block tells search engines that the website is owned by a specific organization, linking its identity to its social coordinates.

Article Schema

Article schema is used for blog posts, news articles, and guides. It helps search engines parse the title, publication date, author details, and header images, earning your pages a spot in Google's News carousels.

JSON-LD Template:

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Structured Data Essentials: Building JSON-LD Schema",
  "image": ["https://yoursite.com/images/article-header.jpg"],
  "datePublished": "2026-02-06T08:00:00+08:00",
  "dateModified": "2026-02-06T09:30:00+08:00",
  "author": {
    "@type": "Person",
    "name": "Nabil Thange",
    "url": "https://yoursite.com/about"
  }
}

Using

BlogPosting
or
NewsArticle
schema ensures your articles are parsed correctly and displayed with appropriate metadata in search feeds.

Person Schema

Person schema defines a specific individual, outlining their name, job title, credentials, and relationship to other entities. This is a critical signal for Google's E-E-A-T evaluator systems.

JSON-LD Template:

{
  "@context": "https://schema.org",
  "@type": "Person",
  "@id": "https://yoursite.com/about/#person",
  "name": "Nabil Thange",
  "jobTitle": "Full-Stack Developer",
  "worksFor": {
    "@type": "Organization",
    "name": "Nabil's Tech Labs"
  },
  "sameAs": [
    "https://twitter.com/nabilthange",
    "https://github.com/nabilthange"
  ]
}

By linking this schema to your Article author properties, you verify the author's identity and professional credibility.

FAQ Schema

FAQPage schema is used when your page features a dedicated list of questions and answers. Earning FAQ rich results allows your Q&A content to display directly inside search listings, increasing search footprint size.

JSON-LD Template:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is JSON-LD?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "JSON-LD is a method of encoding structured data using JSON, designed to help search engines parse page entities."
      }
    },
    {
      "@type": "Question",
      "name": "Is schema markup a ranking factor?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema is not a direct ranking factor, but it increases click-through rates by enabling rich results in search layouts."
      }
    }
  ]
}

BreadcrumbList schema maps your page's location in your site's hierarchy. This changes standard URL paths in search listings to clean, clickable breadcrumb paths (e.g.,

Home > Blog > SEO
).

JSON-LD Template:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://yoursite.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://yoursite.com/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Structured Data",
      "item": "https://yoursite.com/blog/structured-data-essentials"
    }
  ]
}

How to Validate

Always validate your structured data before deploying it to production. Syntactical errors like missing commas or unmatched curly braces will cause search engines to ignore the entire schema block.

Use these validation tools:

  1. Google Rich Results Test: Paste your URL or raw HTML code to test if your schema qualifies for search page rich results (like FAQs or product ratings).
  2. Schema Markup Validator (Schema.org): A strict syntax checker that validates your code structure against the official Schema.org standards.

Common Mistakes

  • Syntax errors in JSON-LD: Omitting trailing commas or using double quotes incorrectly, breaking the script block.
  • Data mismatching: Listing different prices, dates, or names in the schema than what is actually displayed on the visible HTML page.
  • Using outdated formats: Relying on Microdata or RDFa formats rather than Google's preferred JSON-LD format.
  • Forgetting self-referencing @ids: Leaving schemas as disconnected nodes instead of linking them using unified
    @id
    tags.

Key Takeaways

  • Structured data translates page content into machine-readable entity schemas.
  • Implement JSON-LD inside
    <script type="application/ld+json">
    tags.
  • Use Person and Organization schemas to provide E-E-A-T validation signals.
  • FAQ schema helps display Q&A blocks directly inside search listings.
  • Validate your scripts using the Google Rich Results Test to avoid indexing blockages.

Practical Exercise

Construct a complete

BreadcrumbList
schema representing your blog's hierarchy, save it to a script block, and test it in the Schema Markup Validator.

Series Navigation:

Previous: International SEO & Hreflang · Next: E-commerce Rich Results Schema →

In This Series: 14. AI Crawler & robots.txt 15. International SEO & Hreflang 16. Structured Data Essentials (you are here) 17. E-commerce Rich Results Schema

View Full Series (37 chapters) →