The Complete Guide to Schema Markup

Schema markup is structured data you add to a page to describe its content explicitly: this is an article, this is its author, this is a product and its price. Search engines read it to understand your page more confidently, and that understanding can unlock rich results — the star ratings, FAQ dropdowns, and other enhanced listings you see in search.

Why it matters

Plain HTML tells an engine what words are on the page; structured data tells it what those words mean. That clarity can make a page eligible for richer presentation in results, which often improves click-through even without a change in ranking position.

JSON-LD is the format to use

There are a few ways to express structured data, but JSON-LD is the format search engines recommend. It sits in a single script block in your page's head or body, separate from your visible HTML, which makes it easy to add and maintain without touching your layout.

The schema types worth knowing

You don't need all of schema.org's vocabulary — a handful of types cover most real-world needs:

• Article / BlogPosting — for editorial content and blog posts.
• Product — with offers, price, and availability for ecommerce.
• FAQPage — for question-and-answer sections.
• LocalBusiness — name, address, phone, hours for physical locations.
• Breadcrumb — to show your site hierarchy in results.
• Organization — your brand's name, logo, and social profiles.
• HowTo — for step-by-step instructional content.

How to add it to a page

1. Choose the type that matches your page's main content.
2. Generate the JSON-LD with the right fields filled in.
3. Paste it inside a script tag with type "application/ld+json".
4. Validate it before publishing and after deploying.

The one rule you can't break

Structured data must reflect content that's actually visible on the page. Marking up reviews you don't display, prices that aren't real, or FAQs that don't appear is against search engine guidelines and can earn a manual penalty. Honest markup is the only kind worth shipping.

Schema describes reality. If the markup and the page disagree, fix the markup — never fake the page.

Start small and expand

You don't need to mark up everything at once. Begin with the type that fits your most important template — Product for a store, Article for a blog — get it validated and live, then layer on Breadcrumb, Organization, and FAQ over time. Each addition gives engines a clearer picture of your site.