Missing Schema Markup? How to Add It — Beginner's Guide
Schema markup is a small piece of code you add to your website that helps Google understand exactly what your page is about. Without it, you are missing out on rich results — the star ratings, FAQ dropdowns, and enhanced listings that make your page stand out in search results. This guide walks you through exactly what schema markup is, how to generate it using the AIPageSEO Schema Generator, and how to add it to your page — step by step, with no coding experience needed.
What you will learn in this guide
- What schema markup is and why Google uses it to show rich results
- How to check if your page is missing schema markup using AIPageSEO
- Which schema type is right for your page
- How to generate valid schema markup using the AIPageSEO Schema Generator — no coding needed
- How to add the generated code to your HTML file using Notepad++
- How to upload the updated file back to your website using FileZilla
- How to check Google has recognised your new schema markup
1 What is schema markup — and why does it matter?
Before you touch any code, you need to understand what schema markup is, what it does, and why Google rewards pages that have it.
What schema markup actually is
Schema markup is a piece of code — written in a format called JSON-LD — that you add to your HTML file. It does not change how your page looks to visitors. What it does is give Google a precise, machine-readable description of what your page contains. Instead of Google having to guess whether your page is a recipe, a product, a local business, or an FAQ — you tell it directly.
What are rich results?
When Google understands your page content through schema markup, it can display your search result in an enhanced format called a rich result. These take up more space on the search results page and stand out visually from standard results. Examples include:
| Schema type | What it unlocks in Google |
|---|---|
| FAQPage | Expandable FAQ questions shown directly below your result |
| Product | Star ratings, price, and availability shown in search results |
| Article | Author name, date published, and image shown in results |
| LocalBusiness | Address, phone, opening hours shown in Google Maps and search |
| HowTo | Step-by-step instructions shown directly in search results |
| Recipe | Cooking time, ratings, and calories shown in results |
What happens if your page has no schema markup
Without schema markup your page appears as a standard plain result in Google — just a title, URL and meta description. Your competitors who have schema markup get richer, more prominent results that attract more clicks even if they rank lower than you. You are essentially giving away clicks for free.
Standard blue title
yourdomain.com/page
Short description of the page content.
Enhanced title with more visibility
yourdomain.com/page
Short description of the page content.
▼ What is schema markup?
▼ How do I add schema to my page?
▼ Is schema markup free?
2 Check if your page has schema markup
Before you add anything, find out whether your page already has schema markup and if so whether it is valid.
- 1 Go to the AIPageSEO audit tool Open a new browser tab and go to https://aipageseo.com/seo-audit-platform.html. You do not need an account.
-
2
Enter your page address
Type the full address of the page you want to check, for example
https://yourdomain.com. Make sure you include thehttps://at the start. - 3 Click Run Audit and wait It usually takes 10–30 seconds. Do not close the tab or refresh while it runs.
-
4
Find the Schema Markup result
Scroll down to the Schema or Structured Data section. Look for the Schema row:
Status What it means What to do 🔴 Missing No schema markup found at all Follow all steps in this tutorial 🔴 Invalid JSON Schema exists but contains errors Use the Schema Generator to create a clean replacement 🟡 Wrong type Schema type does not match page content Generate the correct type — see Section 3 🟡 Missing fields Schema exists but is incomplete Regenerate with all required fields 🟢 Pass Schema is valid and complete No action needed right now
3 Choose the right schema type for your page
Before you generate anything, you need to know which schema type matches your page. Using the wrong type means Google will not display rich results for it. Use the table below to identify yours.
| Your page is... | Schema type to use |
|---|---|
| A blog post or news article | Article or BlogPosting |
| A product or shop page | Product |
| A page with questions and answers | FAQPage |
| A step-by-step guide or tutorial | HowTo |
| A local business location page | LocalBusiness |
| A recipe | Recipe |
| An event | Event |
| A review or review page | Review or AggregateRating |
| A general website homepage | WebSite or Organization |
4 Generate your schema markup using AIPageSEO
You do not need to write schema markup by hand. The AIPageSEO Schema Generator reads your page and creates valid, correctly formatted schema code for you. Here is exactly how to use it.
- 1 Go to the AIPageSEO Schema Generator Open a new browser tab and go to https://aipageseo.com/schema-tools.html.
-
2
Enter your page URL
Type the full URL of the page you want to add schema to, for example
https://yourdomain.com/about. The tool will read your page content and suggest the most appropriate schema types. - 3 Select your schema type The generator will suggest types based on your page content. Select the one that matches your page from Section 3 above. If you are unsure, the tool will highlight the most suitable option.
- 4 Review and complete the fields The generator will pre-fill as many fields as it can from your page content. Check each field and fill in any that are empty. For example if it is a LocalBusiness schema, make sure your address, phone number and opening hours are correct.
-
5
Generate the code
Click the Generate Schema button. The tool will produce a block of JSON-LD code. It will look something like this:
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Your Page Title", "author": { "@type": "Person", "name": "Your Name" }, "datePublished": "2026-01-01" } </script>
-
6
Copy the generated code
Click the Copy button or select all the generated code and press
Ctrl + C(Windows) or⌘ Cmd + C(Mac) to copy it. Keep this tab open — you will paste this code into your HTML file in the next section.
5 Add the schema code to your HTML file
You now have your generated schema code copied. In this section you will open your HTML file in Notepad++ and paste the code into the correct place.
Where does schema markup go in the file?
Schema markup must go inside the <head> section of your HTML file — the same area where your title tag and meta description live. It must go before the closing </head> tag. If you put it in the wrong place it will not work.
- 1 Open FileZilla and connect to your server Fill in the four boxes at the top of FileZilla — Host, Username, Password, leave Port blank — and click Quickconnect. If you need help with this see the Before You Start guide linked above.
-
2
Navigate to your website folder
Double-click
httpdocs(Plesk) orpublic_html(cPanel) in the right panel to see your website files. -
3
Download a backup copy first
Right-click the file you want to edit and choose Download. In the left panel rename the downloaded file to
filename-backup.html. Then download the file again to your Desktop as your working copy. - 4 Open the file in Notepad++ Open Notepad++ → File → Open → navigate to your Desktop → click the file → click Open.
-
5
Find the closing head tag
Press
Ctrl + F. In the search box type</head>and press Enter. Notepad++ will jump to that line. This is where you will paste your schema code — on a new line just before</head>. -
6
Click just before the closing head tag
Click at the very beginning of the
</head>line. Press Enter to create a new blank line above it. Your cursor should now be on the blank line above</head>. -
7
Paste your schema code
Press
Ctrl + V(Windows) or⌘ Cmd + V(Mac) to paste the schema code you copied from the AIPageSEO Schema Generator. The code will appear on the blank line above</head>. Your file should now look like this:<meta name="description" content="Your description here." /> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Your Page Title" } </script> </head> -
8
Save the file
Press
Ctrl + S. The red dot on the tab disappears when the file is saved.
6 Upload your file and verify the schema
- 1 Switch back to FileZilla Click on the FileZilla window in your taskbar. If it has disconnected, fill in the boxes again and click Quickconnect.
- 2 Upload the edited file Find the edited file on your Desktop in the left panel. Right-click it and choose Upload. Click Overwrite when prompted. When the progress bar disappears the upload is complete.
- 3 Verify the schema is live Go to https://search.google.com/test/rich-results and enter your page URL. Google will confirm whether it can detect your schema markup and whether your page is now eligible for rich results.
- 4 Request indexing in Google Search Console Log in to Google Search Console, use the URL Inspection tool, enter your page URL and click Request Indexing. This speeds up Google discovering your new schema markup.
7 Common mistakes to avoid
-
⚠
Pasting schema in the wrong place
Schema markup must go inside the
<head>section — not in the<body>. If you paste it in the wrong place Google will not find it. Always search for</head>and paste just before it. - ⚠ Using the wrong schema type Adding Article schema to a product page or FAQPage schema to a homepage will not unlock rich results for those pages. Match the schema type to the actual content on the page — refer to the table in Section 3.
- ⚠ Leaving required fields empty Each schema type has required fields. A Product schema without a price, or an Article schema without an author, will fail Google's rich results validation. The AIPageSEO Schema Generator flags missing required fields — fill them all in before copying the code.
- ⚠ Breaking the JSON with a typo If you manually edit the generated schema code and accidentally delete a quote mark, comma or curly bracket, the entire block becomes invalid. If this happens, go back to the AIPageSEO Schema Generator and generate a fresh copy rather than trying to fix it by hand.
- ⚠ Expecting rich results immediately Google may take days or weeks to start showing rich results even after your schema is valid and indexed. Rich results are not guaranteed — Google decides whether to show them based on various quality signals. A valid schema is the first step, not an instant guarantee.