Add Schema Markup to Your Website: A Step-by-Step Start
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 callHow 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:
| Step | What you do | Free tool |
|---|---|---|
| 1. Pick the type | Match the page to one schema type | Google's search gallery |
| 2. Check what's already there | Many platforms add some markup for you | Rich Results Test |
| 3. Write it | Fill in a JSON-LD block | A generator, or by hand |
| 4. Add it | SEO settings, plugin or page head | Your website platform |
| 5. Test and confirm | Fix errors, then check Google saw it | Rich 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:
| Page | Type to start with |
|---|---|
| Home page | Organization (name, logo, phone, social profiles) |
| Contact or location page | LocalBusiness, or a narrower kind like Plumber, Dentist or AccountingService |
| Blog post | Article |
| Product page | Product |
| Class, workshop or open house | Event |
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.
| Platform | What it adds on its own | Where you add your own |
|---|---|---|
| WordPress | Nothing by itself. Yoast SEO, including the free version, adds JSON-LD automatically (Yoast) | The SEO plugin's settings |
| Wix | Local 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 |
| Squarespace | Run the Rich Results Test to see | Code Injection, on Core, Plus, Advanced and some legacy plans (Squarespace Help Center) |
| Shopify | Themes can output Product and Article markup through a built-in filter (Shopify Dev docs) | Theme code or an app |
| Custom site | Nothing | The 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:
| Line | What goes in it | Example |
|---|---|---|
| `@context` | Always the same | `https://schema.org` |
| `@type` | Your type from step 1 | `Plumber` |
| `name` | Business name as shown on the page | Riverside Plumbing |
| `address` | Street, city, state or province, postal code, country | 12 Main St, Austin, TX 78701, US |
| `telephone` | The number on the page | +1-512-555-0100 |
| `url` | This page's full address | https://example.com/contact |
| `openingHoursSpecification` | Days and hours | Monday 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).
- 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).
- 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).
- 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).
- 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?
- You want to know what schema can and can't do for local rankings and AI: local business schema markup
- You're still choosing a platform: is Wix or Squarespace bad for SEO?
- URL Inspection says the page isn't indexed: crawled or discovered, currently not indexed
- You'd rather have markup, pages and profile kept right for you: SEO & GEO Agent