DEV Community

Sara Casciaro
Sara Casciaro

Posted on

Schema Markup JSON-LD for Local Businesses: A Practical Implementation Guide

#webdev #seo #javascript #wordpress

If you have ever wondered why some businesses show up in Google search with rich results like star ratings, address, opening hours and service area, while others appear as plain blue links, the answer is almost always structured data. Specifically, JSON-LD schema markup.

This guide walks through exactly how to implement LocalBusiness schema for small and medium-sized businesses, why it matters more than most developers think, and the common mistakes that make it useless even when it is technically present.

What JSON-LD Schema Markup Actually Does

Schema markup is a vocabulary of tags you add to your HTML that helps search engines understand your content in a structured, machine-readable way. JSON-LD (JavaScript Object Notation for Linked Data) is Google's preferred format. It sits in a script tag in your document head, completely separate from your visible HTML, which makes it easy to implement and maintain without touching your layout.

For local businesses, the LocalBusiness schema type tells Google exactly who you are, what you do, where you are, when you are open, and how to contact you. This structured signal complements your Google Business Profile and helps Google display your information accurately in search results, Maps, and increasingly in AI-generated answer summaries.

The SEO value is real. According to Google's own documentation, properly implemented structured data can enable rich results that significantly improve click-through rates compared to plain organic listings. For local businesses competing in a specific geographic area, this visibility advantage is concrete and measurable.

The Basic LocalBusiness JSON-LD Structure

Here is a clean, minimal implementation for a professional services business:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ProfessionalService",
  "name": "Your Business Name",
  "description": "A clear, specific description of what your business does and who it serves.",
  "url": "https://yourdomain.com",
  "telephone": "+39000000000",
  "email": "hello@yourdomain.com",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Via Example 1",
    "addressLocality": "Your City",
    "addressRegion": "Province",
    "postalCode": "00000",
    "addressCountry": "IT"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 40.0000,
    "longitude": 18.0000
  },
  "areaServed": {
    "@type": "Country",
    "name": "Italy"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:00"
    }
  ],
  "priceRange": "€€",
  "sameAs": [
    "https://www.facebook.com/yourbusiness",
    "https://www.linkedin.com/company/yourbusiness"
  ]
}
</script>
Enter fullscreen mode Exit fullscreen mode

The @type value ProfessionalService is a subtype of LocalBusiness. Always use the most specific type that fits your client. Schema.org lists dozens of subtypes: Restaurant, MedicalBusiness, LegalService, HomeAndConstructionBusiness, and many more. The more specific your type, the better Google understands the business category.

The geo coordinates are optional but strongly recommended for local SEO. They remove any ambiguity about exact location, especially in areas where street address matching might be imprecise.

Choosing the Right @type

This is where most implementations go wrong. Using generic LocalBusiness as a type works, but you are leaving precision on the table. Google uses the specific type to determine which rich result features are applicable and how to categorize the business in local search.

Here is a quick reference for common business types:

Restaurant           → schema.org/Restaurant
Dental Clinic        → schema.org/Dentist
Law Firm             → schema.org/LegalService
Photography Studio   → schema.org/PhotographyBusiness
Web Agency           → schema.org/ProfessionalService
Hair Salon           → schema.org/HairSalon
Hotel or B&B         → schema.org/LodgingBusiness
E-commerce Store     → schema.org/Store
Enter fullscreen mode Exit fullscreen mode

For service-area businesses without a physical storefront, like freelancers and remote agencies, omit the address field and use areaServed instead:

"areaServed": [
  { "@type": "City", "name": "Rome" },
  { "@type": "City", "name": "Milan" }
]
Enter fullscreen mode Exit fullscreen mode

Or for country-wide service:

"areaServed": {
  "@type": "Country",
  "name": "Italy"
}
Enter fullscreen mode Exit fullscreen mode

WordPress Implementation: The Right Way

Plugins like RankMath and Yoast generate schema automatically, but they do not always give you granular control and sometimes produce bloated or incorrect output.

The cleanest approach is injecting custom JSON-LD directly via functions.php, bypassing auto-generated schema entirely:

function add_local_business_schema() {
    if ( is_front_page() ) {
        $schema = [
            '@context' => 'https://schema.org',
            '@type'    => 'ProfessionalService',
            'name'     => get_bloginfo('name'),
            'url'      => home_url(),
        ];
        echo '<script type="application/ld+json">' .
             wp_json_encode($schema, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) .
             '</script>';
    }
}
add_action('wp_head', 'add_local_business_schema');
Enter fullscreen mode Exit fullscreen mode

Using wp_json_encode with JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE keeps the output clean and readable.

If you are using WPCode for custom code injection, add the snippet as a PHP snippet with "Site Wide Header" placement. It works without touching theme files and survives theme updates.

The areaServed vs Address Distinction

A business can serve an entire country while being physically located in a small town. Schema handles these as two separate fields.

address tells Google where the business is physically located. It feeds into Google Maps and the local pack for geographic proximity signals.

areaServed tells Google where the business can serve clients. For a remote digital studio, this might be all of Italy even if the physical office is in a small town in Puglia.

Both should coexist when applicable:

"address": {
  "@type": "PostalAddress",
  "streetAddress": "Via Sant'Antonio 68",
  "addressLocality": "Ugento",
  "postalCode": "73059",
  "addressCountry": "IT"
},
"areaServed": {
  "@type": "Country",
  "name": "Italy"
}
Enter fullscreen mode Exit fullscreen mode

Common Implementation Mistakes

Duplicate schema with conflicting data. If RankMath or Yoast is generating schema automatically and you are also adding custom JSON-LD, you end up with two conflicting schemas on the same page. Always check with Google's Rich Results Test before assuming your implementation is clean.

NAP inconsistency. Name, Address and Phone number in your schema must exactly match your Google Business Profile, your website footer, and every directory listing. Even minor variations like "Via S. Antonio" vs "Via Sant'Antonio" weaken your local SEO signals. This is one of the most common and most damaging mistakes in local SEO.

Missing @id for linked data. Adding an @id property makes your schema node referenceable across multiple pages:

"@id": "https://yourdomain.com/#organization"
Enter fullscreen mode Exit fullscreen mode

This matters when you want blog posts, service pages and team pages to all reference the same organization entity.

Generic descriptions. The description field gets indexed. Write it like a focused meta description: specific, keyword-aware, under 160 characters. Be explicit about what the business does and who it serves.

Wrong opening hours format. Days of the week must be full English strings: Monday, Tuesday and so on. Not abbreviations. Violations silently break rich result eligibility without throwing visible errors.

Validating Your Implementation

Use Google's Rich Results Test to validate your JSON-LD and preview how Google reads it. Use Schema.org's validator for a more detailed structural check.

Pay attention to warnings, not just errors. A schema can be technically valid but still missing properties that unlock specific rich result types.

In Google Search Console, the Enhancements section shows detected structured data across your site after Google crawls the updated pages.

What to Expect After Implementation

Structured data does not produce overnight ranking changes. It typically takes two to four weeks for Google to recrawl affected pages and update its index.

The impact you are looking for is in rich result eligibility, knowledge panel accuracy, and local pack performance. For local businesses competing in specific geographic areas, clean schema plus an optimized Google Business Profile plus consistent NAP across directories is one of the most reliable local SEO foundations you can build.

Written by Sara Casciaro, founder of Sabriel Agency, digital studio in Ugento (LE), Italy.

Top comments (0)