Files
Kordant/tasks/web-production/27-structured-data.md
2026-05-26 16:06:34 -04:00

2.7 KiB

27. Structured Data & Rich Snippets

meta: id: web-production-27 feature: web-production priority: P2 depends_on: [] tags: [seo, marketing, production]

objective:

  • Implement schema.org structured data to enable rich snippets in search results and improve SEO

deliverables:

  • JSON-LD structured data on all relevant pages
  • Organization schema
  • WebSite schema with search
  • Article schema for blog posts
  • SoftwareApplication schema
  • BreadcrumbList schema

steps:

  1. Add Organization schema to homepage:
    • @type: Organization
    • name: Kordant
    • url: https://kordant.com
    • logo: URL to logo image
    • sameAs: social media profiles
    • description: AI-powered identity protection
  2. Add WebSite schema:
    • @type: WebSite
    • url: https://kordant.com
    • potentialAction: SearchAction with search URL template
  3. Add SoftwareApplication schema:
    • @type: SoftwareApplication
    • name: Kordant
    • applicationCategory: SecurityApplication
    • operatingSystem: Web, iOS, Android
    • offers: Free tier, Plus ($12/mo), Premium ($29/mo)
    • aggregateRating (once reviews collected)
    • featureList: DarkWatch, VoicePrint, SpamShield, HomeTitle, RemoveBrokers
  4. Add Article schema for blog posts:
    • @type: Article
    • headline, author, datePublished, dateModified
    • image, articleBody, keywords
    • publisher (Organization reference)
  5. Add BreadcrumbList schema:
    • Dynamic breadcrumbs based on current route
    • Include in all non-home pages
  6. Add FAQPage schema (optional):
    • For /about or /features pages
    • Common questions and answers
  7. Validate all structured data:
    • Test with Google Rich Results Test
    • Test with Schema Markup Validator
    • Fix any warnings or errors

tests:

  • Unit: Test JSON-LD generation for each schema type
  • Integration: Verify schema present in page source
  • SEO: Validate with Google's tools

acceptance_criteria:

  • Organization schema on homepage
  • WebSite schema with SearchAction on homepage
  • SoftwareApplication schema with pricing and features
  • Article schema on all blog posts
  • BreadcrumbList on all non-home pages
  • All schemas pass Google Rich Results Test
  • No errors or warnings in Schema Markup Validator
  • Schemas dynamically generated based on page data

validation:

  • View homepage source → Organization and WebSite JSON-LD present
  • View blog post source → Article JSON-LD with correct dates
  • Google Rich Results Test → all schemas valid
  • Search console → rich results reported

notes:

  • Use @solidjs/meta or script tags in JSX for JSON-LD
  • Keep JSON-LD in <head> for optimal crawler discovery
  • Update SoftwareApplication schema when pricing changes
  • Consider adding Review schema once user reviews available