Products SEO & GEO Agent Paid Ads Agent Website Agent Conversion Agent
How it works Pricing FAQ Blog Book a call

Add Schema Markup to Your Website: A Step-by-Step Start

Updated · 8 min read

Short answer Pick one page and the schema type that matches it, such as LocalBusiness for your contact page. Write it as JSON-LD, the format Google recommends. Add it through your platform's SEO settings, a plugin or the page head. Test it in Google's Rich Results Test, then confirm Google found it with URL Inspection in Search Console.

Want help applying this to your business? Talk it through on a free 30-minute call.

Book a call

How to add schema markup: the five steps

Start with one page, not the whole site. Schema markup (also called structured data) is a short block of code that labels facts on a page, like your business name, address and hours, so search engines read them without guessing. Here is the whole job:

StepWhat you doFree tool
1. Pick the typeMatch the page to one schema typeGoogle's search gallery
2. Check what's already thereMany platforms add some markup for youRich Results Test
3. Write itFill in a JSON-LD blockA generator, or by hand
4. Add itSEO settings, plugin or page headYour website platform
5. Test and confirmFix errors, then check Google saw itRich Results Test, URL Inspection

Set expectations first. Markup makes a page eligible for rich results (search listings with extras like a logo, hours or prices). Google says that "does not guarantee" they will show (Google: structured data guidelines). What schema does and doesn't do for rankings and AI answers is in local business schema markup.

Step 1: Choose the right schema type

Use a type Google supports, and the most specific one that fits. Google's guidelines say:

"Try to use the most specific applicable type and property names defined by schema.org for your markup." (Google Search Central: General structured data guidelines)

Schema.org lists far more types than Google uses, and only some change how Google shows a page. Google's search gallery lists the ones it uses, including Local business, Organization, Breadcrumb, Product snippet, Event, Article and Review snippet (Google: search gallery). For a typical service business:

PageType to start with
Home pageOrganization (name, logo, phone, social profiles)
Contact or location pageLocalBusiness, or a narrower kind like Plumber, Dentist or AccountingService
Blog postArticle
Product pageProduct
Class, workshop or open houseEvent

Skip FAQ markup. Google stopped showing FAQ rich results and removed their documentation in June 2026 (Google: documentation updates).

Step 2: Check what your platform already adds

You may already have schema. Run your page through Google's Rich Results Test before adding anything, so you don't end up with two conflicting blocks.

PlatformWhat it adds on its ownWhere you add your own
WordPressNothing by itself. Yoast SEO, including the free version, adds JSON-LD automatically (Yoast)The SEO plugin's settings
WixLocal Business markup on the home page once you enter a business name and location; preset markup on Stores, Bookings, Blog and Events pages (Wix Help Center)Page's SEO basics, Advanced SEO tab, Structured Data Markup
SquarespaceRun the Rich Results Test to seeCode Injection, on Core, Plus, Advanced and some legacy plans (Squarespace Help Center)
ShopifyThemes can output Product and Article markup through a built-in filter (Shopify Dev docs)Theme code or an app
Custom siteNothingThe page's HTML

If a plugin already outputs Organization or LocalBusiness markup, fill in its settings rather than pasting a second block.

Step 3: Write the JSON-LD

Use JSON-LD unless your platform forces something else. Google's words:

"In general, we recommend using a format that's easiest for you to implement and maintain (in most cases, that's JSON-LD)" (Google Search Central: Introduction to structured data markup)

JSON-LD sits in its own script block, apart from the text visitors read, so you can add it without touching your page design (Google: intro to structured data). A LocalBusiness block needs only two properties, `name` and `address` (Google: Local business structured data). A useful first block has these lines:

LineWhat goes in itExample
`@context`Always the same`https://schema.org`
`@type`Your type from step 1`Plumber`
`name`Business name as shown on the pageRiverside Plumbing
`address`Street, city, state or province, postal code, country12 Main St, Austin, TX 78701, US
`telephone`The number on the page+1-512-555-0100
`url`This page's full addresshttps://example.com/contact
`openingHoursSpecification`Days and hoursMonday to Friday, 08:00 to 17:00

For a Canadian business, the country is `CA`: schema.org asks for the two-letter ISO code (schema.org: addressCountry).

You don't have to type it. Google's Structured Data Markup Helper is still online and has a Local Businesses option: enter your page's URL, select the name, address and phone, and it drafts the markup. Wix points users to a markup generator tool and to schema.org templates (Wix Help Center).

Two rules decide whether it counts:

"Don't mark up content that is not visible to readers of the page." (Google Search Central: General structured data guidelines)
"Your structured data must be a true representation of the page content." (same)

If your hours aren't on the page, either add them to the page or leave them out of the markup.

Step 4: Add the markup to your page

Where it goes depends on the platform. Google says a CMS (content management system, like WordPress) "may have a search engine settings page, or you may be able to install a plugin" (Google: intro to structured data).

  • WordPress: fill in your business details in the SEO plugin's settings. Paste raw code only if the plugin can't express what you need.
  • Wix: open Pages & Menu, choose the page's More Actions icon, then SEO basics, Advanced SEO, Structured Data Markup, Add New Markup. Wix accepts JSON-LD only, under 7,000 characters, up to five markups per page (Wix Help Center).
  • Squarespace: for one page, open the page's settings, then Advanced: Page Header Code Injection puts the code in that page's head. Wrap the JSON-LD in a script tag (Squarespace Help Center).
  • Shopify: use an app or ask whoever edits your theme. Duplicate the theme before anyone edits its code.
  • Custom site: paste the script block into the page's head or body. Google reads both (Google: intro to structured data).
  • No code access at all: Google documents a route through Google Tag Manager, which adds code to a site without editing it: create a Custom HTML tag, paste the block, publish the container (Google: structured data with JavaScript).

Step 5: Test it and confirm Google found it

Test before and after publishing. Google's order for LocalBusiness: validate the code in the Rich Results Test and "fix any critical errors", deploy a few pages, then check them with the URL Inspection tool in Search Console (Google: Local business structured data).

  1. Rich Results Test: paste the URL or the code. Critical errors block eligibility. Warnings are optional, Google says, and fixing them is "not necessary to be eligible for rich results" (Google: Local business structured data).
  2. Schema Markup Validator (run by schema.org): checks the code against the full vocabulary, including types Google doesn't use. It replaced Google's old Structured Data Testing Tool in 2021 (Google Search Central Blog, 2020, updated 2021).
  3. URL Inspection: confirms Google has seen the live page and its markup. If it looks right, you can ask Google to recrawl. Google warns it "may take several days" to find and crawl a page (Google: Local business structured data).
  4. Rich result reports in Search Console: Google advises using them after launch, because markup "might break after deployment due to templating or serving issues" (Google: intro to structured data). Setup help: Google Search Console for a small business.

Keep it up to date

Change the markup when the page changes. New hours, phone or address go on the page, in the markup and in your Google Business Profile on the same day, so all three agree. Re-run the Rich Results Test after a theme change or a plugin update: those are the usual reasons markup breaks.

Example

Illustrative cases, not client results.

A dental office on Wix

The Rich Results Test shows Wix already added LocalBusiness markup to the home page. The contact page has none. The office adds one Dentist block there through Advanced SEO, with name, address, phone and the hours printed on the page. The test passes with no errors, and URL Inspection shows the markup a week later.

An electrician on WordPress

The site has Yoast plus a schema plugin, and the test shows two Organization blocks with different phone numbers. The owner turns off the extra plugin and corrects the phone in Yoast's settings. One block, one number.

A Toronto bookkeeper with a hand-coded site

A developer adds an AccountingService block to the contact page, with `CA` as the country and the hours shown on the page. Cost: about 30 minutes of the developer's time, around CAD 50.

FAQ

Do I need to know how to code to add schema markup?

No. WordPress plugins, Wix's SEO settings and Google Tag Manager let you paste a block of text into a box, without editing site code.

Where should JSON-LD go, the head or the body?

Either works. Google reads JSON-LD in the head or the body of the page (Google: intro to structured data).

How long until rich results show up?

Google may take several days to crawl the page again, and even valid markup doesn't guarantee a rich result (Google: Local business structured data).

Should every page have schema?

No. Add it where a type fits: Organization on the home page, LocalBusiness on each location page, Article on blog posts. Other pages can go without.

Is the Structured Data Testing Tool still available?

No. Google retired it in 2021. Use the Rich Results Test for Google features and the Schema Markup Validator for general checks (Google Search Central Blog, 2020, updated 2021).

Different for you?

Keep learning

NextLocal business schema markup: what it does for Google and AIWhat LocalBusiness schema does on Google, which rich results are gone (FAQ, HowTo), whether AI search uses it, and how to add and test it.

Do it yourself

Crawlability checklist: make every page reachable by GoogleA crawlability checklist for a small business site: find orphan pages, robots.txt blocks, broken links, redirect chains and server errors, with free tools.

Ask us one question

One line is enough. We reply by email.

Sources

  1. Google Search Central: Introduction to structured data markup
  2. Google Search Central: General structured data guidelines
  3. Google Search Central: Local business (LocalBusiness) structured data
  4. Google Search Central: Structured data markup that Google Search supports (search gallery)
  5. Google Search Central: Generate structured data with JavaScript (Google Tag Manager)
  6. Google Search Central: Latest documentation updates (FAQ rich result removed, June 2026)
  7. Google Search Central Blog: An update on the Structured Data Testing Tool (2020, updated 2021)
  8. Google Rich Results Test
  9. Schema.org: Schema Markup Validator
  10. Google Structured Data Markup Helper
  11. Schema.org: addressCountry
  12. Wix Help Center: Adding structured data markup to your site's pages
  13. Squarespace Help Center: Using code injection
  14. Yoast: Structured data feature
  15. Shopify Dev: structured_data Liquid filter