Schema Markup for On-Page SEO | Symaxx Resources

Schema markup transforms standard search results into rich results — adding star ratings, FAQ dropdowns, pricing, images, and step-by-step instructions directly in search results. While structured data is technically a technical SEO topic, the decision of what to mark up and how to align it with page content is fundamentally an on-page SEO decision. The right schema on the right page can increase click-through rate by 20–40%.

Schema Types That Impact On-Page SEO

FAQ Schema

Best for: Service pages, product pages, knowledge base articles, and any page that answers common questions.

What it does: Displays expandable FAQ dropdowns directly in search results, significantly increasing your SERP real estate.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How much does web design cost in South Africa?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Web design in South Africa typically costs between R5,000 and R80,000+ depending on complexity, features, and the agency you work with."
      }
    }
  ]
}

On-page alignment rules:

• FAQ questions in schema must exactly match visible FAQ content on the page
• Do not hide FAQ content behind JavaScript tabs if using FAQ schema
• Limit to 5–8 FAQ items for optimal display

How-To Schema

Best for: Tutorial pages, guides, documentation, and any content with sequential steps.

What it does: Displays numbered steps, estimated time, and required tools in search results.

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Run an SEO Audit",
  "estimatedCost": { "@type": "MonetaryAmount", "currency": "ZAR", "value": "0" },
  "totalTime": "PT2H",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Crawl your website",
      "text": "Use Screaming Frog or Sitebulb to crawl all pages and identify technical issues."
    }
  ]
}

On-page alignment rules:

• Steps in schema must match visible step content on the page
• Include estimatedCost and totalTime where applicable
• Steps should be genuinely sequential, not just bullet points relabelled

Article Schema

Best for: Blog posts, news articles, documentation pages.

What it does: Helps Google understand the content type, author, publication date, and headline — supporting Article rich results and Google Discover eligibility.

{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Redirect Management for SEO",
  "author": { "@type": "Person", "name": "Bukhosi Moyo" },
  "datePublished": "2026-03-05",
  "dateModified": "2026-03-05",
  "publisher": { "@type": "Organization", "name": "Symaxx Digital" }
}

On-page alignment rules:

• Use TechArticle for technical documentation, Article for general blog posts
• headline must match the page's H1
• Author information should be visible on the page (not just in schema)

Product Schema

Best for: Service pages, pricing pages, product listings.

What it does: Displays price, availability, and review ratings in search results.

On-page alignment rules:

• Price in schema must match visible price on the page
• Review ratings must come from genuine reviews
• Product name must match the visible page title or product name

Review / AggregateRating Schema

Best for: Pages displaying reviews or testimonials.

What it does: Displays star ratings in search results — one of the most click-driving rich result types.

On-page alignment rules:

• Ratings must be based on genuine user reviews visible on the page
• Google penalises self-serving reviews (a business rating itself)
• Review content must be original, not copied from third-party platforms

Breadcrumb Schema

Best for: Every page on the site.

What it does: Displays the site hierarchy in search results instead of the raw URL, improving readability and click-through rate.

On-page alignment rules:

• Breadcrumb schema must match visible breadcrumb navigation on the page
• Every level in the breadcrumb must link to a real, accessible page

Implementing Schema on Content Pages

Strategy: Match Schema to Page Purpose

Page Type	Primary Schema	Secondary Schema
Service page	Product or Service	FAQ, Breadcrumb
Blog post	Article	Breadcrumb, FAQ
Documentation article	TechArticle	Breadcrumb, HowTo
Pricing page	Product (with pricing)	FAQ, Breadcrumb
Landing page	WebPage	FAQ, Breadcrumb
How-to guide	HowTo	Article, Breadcrumb
Category/hub page	CollectionPage	Breadcrumb

Implementation in Next.js

// In a page component (App Router)
export default function ServicePage() {
  const jsonLd = {
    '@context': 'https://schema.org',
    '@type': 'Service',
    name: 'SEO Services Pretoria',
    description: 'Professional SEO services...',
    provider: {
      '@type': 'Organization',
      name: 'Symaxx Digital',
    },
  }

  return (
    <>
      <script
        type="application/ld+json"
        dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
      />
      {/* Page content */}
    </>
  )
}

Schema Validation

Always validate before publishing:

1. Google Rich Results Test: https://search.google.com/test/rich-results
2. Schema.org Validator: https://validator.schema.org
3. Google Search Console: Monitor the Enhancements section for schema errors over time

Common Schema Mistakes

Marking up invisible content: Schema data must match visible page content. Google penalises pages where schema describes content that users cannot see.

Overusing FAQ schema: Adding FAQ schema to every page dilutes its impact. Use it where genuine FAQs exist and add value.

Incorrect nesting: Schema types must be properly nested. An AggregateRating inside a Product is fine; an AggregateRating on its own is not useful.

Stale schema: When page content is updated, schema must be updated to match. Outdated prices, ratings, or steps in schema violate Google's guidelines.

Multiple conflicting types: A page should have one primary schema type. Multiple conflicting types (e.g., both Product and Article when the page is clearly a blog post) confuse Google.

Key Takeaways

• Schema markup bridges on-page content and search engine understanding — apply it strategically, not everywhere.
• FAQ, HowTo, Article, Product, and Breadcrumb are the highest-impact schema types for most sites.
• Schema content must exactly match visible page content — no exceptions.
• Use JSON-LD format and validate with Google's Rich Results Test.
• Rich results increase CTR by 20–40%, making schema one of the highest-ROI on-page optimisations.

Quick Schema Implementation Checklist

• Page purpose identified (blog, service, docs, product)
• Primary and secondary schema types selected
• Schema content matches visible page content exactly
• JSON-LD placed in page head
• Validated with Rich Results Test (no errors)
• Breadcrumb schema implemented site-wide
• Search Console Enhancements monitored for errors
• Schema updated whenever page content changes

Related SEO Documentation

• Structured Data & Schema Markup
• Structured Data for AI Engines
• Featured Snippets — How to Win Position Zero
• Schema Testing Tools
• What Is On-Page SEO?