Skip to content

JSON-LD

Definition

JSON-LD is a lightweight Linked Data format based on JSON that helps JSON data interoperate at Web scale.1

Topic
Local SEO
Updated

JSON-LD is the representation format, not the vocabulary that names a business type. LocalBusiness is a Schema.org type for a particular physical business or branch. A site can express that type in JSON-LD with @context: "https://schema.org" and @type: "LocalBusiness".12 Google says to define each real local business location as LocalBusiness and use the most specific applicable subtype.3 The JSON-LD project defines the format, while Schema.org defines the vocabulary type.12

Google Search supports JSON-LD, Microdata, and RDFa for documented structured-data features. Google generally recommends the format that is easiest to implement and maintain, which is usually JSON-LD.4 Google's LocalBusiness guidance names Restaurant, DaySpa, and HealthClub as examples of more specific subtypes.3 Those names are vocabulary types, not formats; JSON-LD is one format for expressing structured data.123

The markup belongs on the page that describes the business, usually in a JSON-LD script in the page's HTML head or body. Google says LocalBusiness can be added to any page, although a page containing the business information may make more sense. Define each local business location as LocalBusiness and use the most specific applicable subtype. Only state facts the page shows to the reader. For Google's LocalBusiness rich-result feature, name and address are required properties; fields such as hours, geo, telephone, and URL are recommended when applicable.43

Meeting a documented feature's structured-data requirements can make a Search feature eligible, but Google does not guarantee that the feature will appear.45 Google also says AI Overviews and AI Mode need no special Schema.org structured data. To be eligible as a supporting link in those features, a page must be indexed and eligible for a Google Search snippet, and Google does not guarantee crawling, indexing, or serving.6 The Google Business Profile and AI search pages cover those broader surfaces.

JSON-LD is therefore not the same as LocalBusiness, Schema.org, Microdata, or RDFa. It is one representation format. LocalBusiness is one vocabulary type. Google Search decides how supported markup may qualify for its features.1245

4 more paragraphs

Maps Agent service

Where your profile stands now

Visibility Score 0-100 · 20 scored factors · free · no signup

Profile Completeness
11 checks · 40% of score
Performance
4 checks · 35% of score
Competitive Position
5 metrics · 25% of score
Run the free auditAI Team · $99/mo

Sources

  1. 1
    LD - JSON for Linked DataJSON-LD projectJSON-LD format definition
  2. 2
    LocalBusiness - Schema.org TypeSchema.orgLocalBusiness type definition
  3. 3
    Local Business (LocalBusiness) Structured Data | Google Search Central | Documentation | Google for DevelopersGoogle Search CentralLocalBusiness properties and guidance (last updated 2026‑09‑08)
  4. 4
    Intro to How Structured Data Markup Works | Google Search Central | Documentation | Google for DevelopersGoogle Search Centralstructured-data formats and placement (last updated 2025‑12‑10)
  5. 5
    General Structured Data Guidelines | Google Search Central | Documentation | Google for DevelopersGoogle Search Centralstructured-data eligibility and limits (last updated 2026‑07‑10)
  6. 6
    AI Features and Your Website | Google Search Central | Documentation | Google for DevelopersGoogle Search CentralGoogle AI feature guidance (last updated 2025‑12‑10)