Skip to content
GigAI Tools
7 steps

How to Add Schema Markup to a Page (Step by Step)

Add structured data to any web page so Google can show rich results, stars, FAQs, breadcrumbs and more. A practical guide using JSON-LD, no coding framework required.

Schema markup is structured data that describes what a page is about in a format search engines understand, a recipe, a product, an FAQ, a local business. Add it correctly and Google can enhance your listing with rich results like star ratings, expandable FAQs and breadcrumb trails, which stand out and often earn more clicks.

The recommended format is JSON-LD: a self-contained block of JSON you drop into the page's HTML, separate from your visible content. It's the easiest to add and maintain because it doesn't touch your markup. This guide shows how to generate valid JSON-LD, place it, and confirm Google can read it.

This guide uses Schema Markup Generator

Free, private and instant. Open it now and follow along with the steps below.

Open Schema Markup Generator

Follow these steps

  1. Step 1: Pick the schema type that matches your page

    Choose the type that describes the page's primary content, Article, Product, FAQ, LocalBusiness, Recipe, Event and so on. Each type expects specific fields, so match it to what the page actually is.

  2. Step 2: Generate the JSON-LD

    Open the schema generator, select your type, and fill in the fields: title, author, price, address, questions and answers, whatever the type requires. The tool builds correctly structured JSON-LD as you type.

  3. Step 3: Copy the generated markup

    Copy the finished <script type="application/ld+json"> block. It's a complete, self-contained snippet. You don't need to edit it further.

  4. Step 4: Paste it into your page's HTML

    Drop the script block into the page, ideally in the <head>, though anywhere in the HTML works. Add it to the specific page it describes, not sitewide, so each page's markup matches its content.

  5. Step 5: Make sure the markup matches what users see

    Structured data must reflect visible page content. If you mark up a 4.8-star rating or a $29 price, that same rating and price should appear on the page. Mismatches can trigger a manual penalty.

  6. Step 6: Validate with Google's Rich Results Test

    Run the live URL (or the raw code) through Google's Rich Results Test. It confirms the type is eligible for rich results and flags missing required or recommended fields.

  7. Step 7: Monitor in Search Console

    After Google recrawls the page, check the Enhancements reports in Search Console to see valid items, warnings and any errors, and to track which rich results you're eligible for.

Tips & best practices

  • Prefer JSON-LD over Microdata or RDFa, Google explicitly recommends it, and it keeps structured data separate from your visible HTML.
  • Only mark up content that's actually on the page. Adding schema for reviews or prices that aren't visible is against Google's guidelines.
  • Fill in recommended fields, not just required ones. Richer, more complete markup is more likely to earn an enhanced listing.
  • Schema markup makes a page eligible for rich results but doesn't guarantee them. Google decides per query whether to show them.

Frequently asked questions