Skip to main content
AI Visibility ScoreGEO AcademyCase StudiesBook a Demo

Technical

What Is JSON-LD? The Technical Foundation of GEO

JSON-LD is how you tell AI systems exactly what your business is and what it does. Here's what it is and why it matters.

schema.json
1{
2
"@context": "https://schema.org",← Tells AI this is structured data
3
"@type": "Plumber",← Your business category
4
"name": "Smith Plumbing",← Exact business name
5
"address": {← Structured location
6 "streetAddress": "123 Main St",
7 "addressLocality": "Austin",
8 "addressRegion": "TX"
9 },
10
"aggregateRating": {← Your review stats
11 "ratingValue": "4.8",
12 "reviewCount": "342"
13 }
14}

Without Schema

AI guesses meaning

With Schema

AI knows exactly

If you want AI systems to understand your business, you need to speak their language. That language is JSON-LD.

JSON-LD stands for JavaScript Object Notation for Linked Data. It's a way of structuring information on your website so machines can read it directly, without having to interpret your page content.

Pro Tip

Think of JSON-LD as a machine-readable business card. Instead of hoping an AI can figure out your business name, address, and services from your website text, you hand it structured data that says explicitly: here's exactly what we are and what we do.

Electrician inspecting an electrical panel

Why this matters for GEO

AI systems pulling information about local businesses face a challenge: the web is messy. Your business name might be styled differently in your logo than in your footer. Your address might be written multiple ways. Your services might be scattered across pages.

JSON-LD solves this by providing clean, standardized data. When an AI system encounters JSON-LD on your site, it can extract your business information with confidence rather than guessing.

"AI recommendations are based on the AI's understanding of your business. The clearer that understanding, the more likely you are to be recommended accurately for relevant queries."

What JSON-LD looks like

Here's a simplified example of LocalBusiness JSON-LD:

```json

{

"@context": "https://schema.org",

"@type": "Plumber",

"name": "Smith Plumbing",

"address": {

"@type": "PostalAddress",

"streetAddress": "123 Main St",

"addressLocality": "Austin",

"addressRegion": "TX",

"postalCode": "78701"

},

"telephone": "+1-512-555-0123",

"aggregateRating": {

"@type": "AggregateRating",

"ratingValue": "4.8",

"reviewCount": "342"

}

}

```

This tells AI systems: this is a plumber named Smith Plumbing at this address with this phone number and this rating based on this many reviews. No interpretation required.

Key schema types for local businesses

LocalBusiness is the foundation, but you should use more specific types when available. Plumber, Electrician, HVACBusiness, BeautySalon. These give AI systems more context about your category.

AggregateRating displays your overall review data. AI systems use this to assess reputation.

Review schema marks up individual reviews on your site. If you display testimonials, structuring them properly makes them machine-readable.

Service schema describes what you offer. If you're a plumber who does water heater installation, emergency repairs, and drain cleaning, each service can be structured.

GeoCoordinates defines your service area. This helps AI systems recommend you for location-specific queries.

Common mistakes

Important

A surprising number of local business websites have no structured data at all. They're invisible to the machine-readable web.

Using generic LocalBusiness when specific types exist. If there's a schema type for your exact business category, use it. More specificity helps.

Inconsistent data. If your JSON-LD says your phone number is 512-555-0123 but your website displays (512) 555-0123 and your Google profile has +15125550123, you've created confusion. Standardize.

Not updating. If your JSON-LD has your old address or outdated rating data, you're sending bad information to AI systems.

Implementation

JSON-LD goes in a script tag in your page's head section. Most website platforms have plugins or settings for adding structured data. If you're using WordPress, there are several schema plugins. If you have a custom site, your developer needs to add this manually.

Pro Tip

After implementation, test with Google's Rich Results Test or Schema.org's validator. These tools will flag errors and missing fields.

This isn't optional anymore. Every local business website should have LocalBusiness schema at minimum. The businesses that do this well give AI systems exactly what they need to recommend them accurately. The ones that don't are trusting AI to figure it out on their own.

Further Reading

Amadeus Peterson is the CTO of Cheers, the GEO platform for local service businesses.

Share this article

Pass it to the operator who still thinks AI visibility is just SEO with a different label.

Share:

Frequently Asked Questions

JSON-LD (JavaScript Object Notation for Linked Data) is a way of structuring information on your website so machines can read it directly. Think of it as a machine-readable business card that tells AI exactly what your business is and does, without interpretation.

AI systems face messy web data: inconsistent business names, addresses written multiple ways, services scattered across pages. JSON-LD gives AI structured, unambiguous data about your business, improving their confidence in recommending you.

Start with LocalBusiness (or a specific subtype like Plumber or BeautySalon), which covers name, address, phone, hours, and service area. Add Service schema for what you offer, and AggregateRating schema to display your review stats.

JSON-LD goes in a script tag in your page's head or body. It's invisible to visitors but readable by search engines and AI systems. Most CMS platforms have plugins to add it, or your developer can implement it directly.

Keep reading

Next step

Is AI recommending your business?

Find out how visible you are across ChatGPT, Gemini, Perplexity, and AI Overviews.