Free tool Local business schema checker
Paste the JSON-LD from a store, restaurant or office page, or enter its URL. The checker finds the LocalBusiness item (or any subtype such as Restaurant or Dentist), checks each property Google documents for local business results, explains what is missing or malformed, and gives you a corrected snippet with the fixes it can make on its own.
- Google’s LocalBusiness rules
- Opening hours checked
- Paste mode runs locally
Check LocalBusiness markup
The example is a fictional café with typical mistakes. Paste your own JSON-LD or page source, or switch Source to “Fetch the live URL” and click Check.
check.tapcub.com, a TapCub service on Cloudflare Workers. It fetches the page from Cloudflare’s network (8-second timeout, up to 5 redirects, first 512 KB of the body), identifies itself with a From: tools@tapcub.com header, and returns the response to your browser, where all the analysis happens. In paste mode nothing is sent: the JSON-LD you paste is checked in your browser. It keeps no copy of the page; its logs hold the domain, status code and timing, not the full URL. Limit: 10 fetches a minute and 200 a day per IP address.Needed to fetch a page. In paste mode it is used to complete relative url values.
Starting with { or [ means JSON-LD; anything else is searched for <script type="application/ld+json"> blocks.
Businesses found
1
Errors
0
Break eligibility
Warnings
8
Missing or malformed recommended data
Checks
For the first business found.
- WarningaddressCountry "United States" should be the two-letter ISO 3166-1 code US. Fixed in the snippet.
- Warninggeo 45.512, -122.653: Google asks for at least 5 decimal places (about 1 m). Fewer can put the pin on the wrong block.
- Warningtelephone "(503) 555-0142" has no country code. Google asks for the country and area code, e.g. +1-503-555-0142.
- Warningurl "/locations/portland" is relative. Use the fully-qualified URL of the location page.
- WarningHours are in openingHours text ("Mo-Fr 07:00-18:00; Sa-Su 08:00-16:00"). Google documents openingHoursSpecification; converted in the snippet.
- WarningCafeOrCoffeeShop: menu is missing. Recommended for food establishments.
- WarningCafeOrCoffeeShop: servesCuisine is missing. Recommended for food establishments.
- WarningaggregateRating or review is present. Google recommends these only for sites that collect reviews about other local businesses; ratings a business publishes about itself are not eligible for star review snippets.
Properties
Required, recommended and conditional properties of the first business.
| Property | Status | Value | Google says |
|---|---|---|---|
name | OK | Northline Coffee | Required |
address | OK | 1200 SE Hawthorne Blvd, Portland, OR, 97214, United States | Required |
geo | Check | 45.512, -122.653 | Recommended |
telephone | Check | (503) 555-0142 | Recommended |
url | Check | /locations/portland | Recommended |
priceRange | OK | $$ | Recommended |
openingHoursSpecification | Fixed | Mo-Fr 07:00-18:00; Sa-Su 08:00-16:00 | Recommended |
menu | Check | — | Recommended for food |
servesCuisine | Check | — | Recommended for food |
aggregateRating | Check | 4.8 (212) | Only for review sites |
image | OK | https://example.com/photos/northline-front.jpg | Restaurant carousel only |
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CafeOrCoffeeShop",
"name": "Northline Coffee",
"image": "https://example.com/photos/northline-front.jpg",
"url": "/locations/portland",
"telephone": "(503) 555-0142",
"priceRange": "$$",
"address": {
"@type": "PostalAddress",
"streetAddress": "1200 SE Hawthorne Blvd",
"addressLocality": "Portland",
"addressRegion": "OR",
"postalCode": "97214",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": 45.512,
"longitude": -122.653
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "212"
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday"
],
"opens": "07:00",
"closes": "18:00"
},
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": [
"Saturday",
"Sunday"
],
"opens": "08:00",
"closes": "16:00"
}
]
}
</script>Placeholders in <angle brackets> need your real data. Remove properties you cannot fill rather than publishing placeholders.
Share these inputs: the values go after the # in the link, so they never reach a server.
https://tapcub.com/tools/local-business-schema-checker
Version v1.0Updated Update history
Which findings matter
Google needs only two properties to understand a local business, but the recommended ones are what make the listing useful.
Errors
A missing name or address, a broken JSON block, or values Google cannot read (hours that are not times, geo that is not a number). Fix these first.
Warnings
Recommended properties that are missing or in the wrong format: phone without a country code, coordinates with too few decimals, a relative URL, hours in the older text format.
Ratings on your own site
Stars from reviews you collect about yourself are not shown for LocalBusiness or Organization. Keeping the markup is harmless; expecting stars from it is the mistake.
The corrected snippet
The checker converts what it can: openingHours text to openingHoursSpecification, country names to codes, 24:00 to 23:59, relative URLs to full ones. Placeholders mark data only you have.
Structured data supports, but does not replace, your Google Business Profile. Keep the name, address and phone identical in both.
Check a location page
Do this for each location page if you have several.
-
1
Paste the markup or enter the URL
Copy the JSON-LD from your CMS or SEO plugin, or paste the whole page source. For a live page, switch Source to Fetch the live URL.
-
2
Read errors, then warnings
Each finding names the property and what Google’s documentation asks for.
-
3
Copy the corrected JSON-LD
Replace any
<placeholder>with real data, or delete the property if you do not have it. -
4
Publish and confirm
Update the page, check it again here by URL, then run Google’s Rich Results Test on the live URL.
What Google asks for
From Google Search Central’s “Local business (LocalBusiness) structured data”. Required properties must be present; recommended ones should be added when the information exists.
- Required:
nameandaddress(a PostalAddress: streetAddress, addressLocality, addressRegion, postalCode, addressCountry) - Recommended:
geo(latitude and longitude, 5+ decimals),telephone(with country and area code),url,priceRange(under 100 characters),openingHoursSpecification,department - Food establishments: also
menu(full URL) andservesCuisine - Hours: open 24 hours = opens 00:00, closes 23:59; closed all day = both 00:00; hours past midnight go in one object for the opening day (Saturday 18:00–03:00); seasonal hours use validFrom / validThrough
| Situation | opens | closes |
|---|---|---|
| Mon–Fri 9 to 5 | 09:00 | 17:00 |
| Open 24 hours | 00:00 | 23:59 |
| Closed all day | 00:00 | 00:00 |
| Saturday night to 3 am | 18:00 | 03:00 (dayOfWeek Saturday only) |
| Holiday closure | 00:00 | 00:00 + validFrom / validThrough |
The example café, checked
The default markup is a fictional coffee shop with mistakes that are common in theme and plugin output.
| Property | In the markup | Finding |
|---|---|---|
| addressCountry | "United States" | Use the code US (fixed in the snippet) |
| geo | 45.512, -122.653 | Only 3 decimals; Google asks for 5 |
| telephone | (503) 555-0142 | No country code: +1-503-555-0142 |
| url | /locations/portland | Relative; use the full URL |
| openingHours | Mo-Fr 07:00-18:00; Sa-Su 08:00-16:00 | Converted to two openingHoursSpecification objects |
| aggregateRating | 4.8 from 212 reviews | Self-serving: no stars for a business rating itself |
| servesCuisine, menu | Missing | Recommended for cafés and restaurants |
Name and address are present, so the café has no errors, only warnings. The clean restaurant example shows the same data with every recommended property filled, including Saturday hours that run past midnight.
What goes wrong in local business markup
Most come from a plugin filling fields from a settings page that was half completed.
Address as one line of text
Google expects a PostalAddress with street, city, region, postal code and country in separate fields.
Hours in the old text format
"Mo-Fr 9-5" strings, 12-hour times or 24:00. Use openingHoursSpecification with 24-hour times.
Rating yourself
Star ratings for reviews of your own business are not shown. Do not add a rating to get stars.
Local-format phone numbers
Include the country code so the number works for everyone and matches your Business Profile.
See what local search brings in
Markup helps search engines understand a location. TapCub shows the visits, searches and enquiries that each location page receives.
Local business schema questions
Still have a question?
Chat with the team behind TapCub — we usually reply within a few hours on business days.
What is LocalBusiness schema?
Structured data, usually JSON-LD, that describes a physical business: name, address, coordinates, phone, opening hours and price range. Google uses it to understand the business and may show the details in search results and Maps.
Which properties are required?
Only name and address. Google recommends geo, telephone, url, priceRange and openingHoursSpecification, plus menu and servesCuisine for food establishments, and asks for as many address fields as possible.
Can I add star ratings for my own business?
You can keep the markup, but Google does not show star review snippets for reviews a LocalBusiness or Organization publishes about itself. aggregateRating and review are meant for sites that collect reviews of other businesses.
How do I mark hours that pass midnight?
Put them in one OpeningHoursSpecification for the day the business opens, with a closing time earlier than the opening time, as in Google’s example: Saturday, opens 18:00, closes 03:00.
Should each location have its own markup?
Yes. Put one LocalBusiness on each location page, with that location’s address, phone and url. Avoid listing every branch on the home page as if it were one place.
Does this replace Google Business Profile?
No. Your Business Profile is managed separately, in Google’s own tools. Structured data on your site is an extra, consistent source; keep the name, address and phone identical in both.
Update history
New features, fixes and data refreshes for this tool, newest first.
-
· v1.0
LaunchedFirst release.
Missing something or found an error? Tell us — requests that come up often go into the next update. All tool updates
Build the markup, then check the page
Generate LocalBusiness JSON-LD from a form, and make sure the page itself can be indexed.