# Schema Markup Implementation Guide for RateRight ## Overview This guide provides comprehensive instructions for implementing schema.org structured data on RateRight's website to enhance search visibility and enable rich results. We'll cover four main schema types essential for RateRight's business: JobPosting, LocalBusiness, Organization, and FAQPage. ## Table of Contents 1. [Implementation Best Practices](#implementation-best-practices) 2. [JobPosting Schema](#jobposting-schema) 3. [LocalBusiness Schema](#localbusiness-schema) 4. [Organization Schema](#organization-schema) 5. [FAQPage Schema](#faqpage-schema) 6. [Testing and Validation](#testing-and-validation) 7. [Common Mistakes to Avoid](#common-mistakes-to-avoid) 8. [Impact on Search Results](#impact-on-search-results) ## Implementation Best Practices ### General Guidelines 1. **JSON-LD Format**: Use JSON-LD (JavaScript Object Notation for Linked Data) as it's Google's preferred format 2. **Placement**: Add schema markup in the `` section of your HTML pages 3. **Dynamic Content**: For frequently changing content (like job postings), implement dynamic generation 4. **Validation**: Always test your markup using Google's Rich Results Test tool 5. **Relevance**: Only mark up content that is visible to users on the page ### Technical Requirements - Use valid JSON syntax - Include all required properties for each schema type - Use ISO 8601 format for dates (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) - Include country codes (ISO 3166-1 alpha-2) for addresses - Use HTTPS URLs where applicable ## JobPosting Schema ### Required Properties - `title`: Job title only (no codes, addresses, or salaries) - `description`: Full HTML-formatted job description - `datePosted`: Original posting date in ISO 8601 format - `hiringOrganization`: Company information - `jobLocation`: Physical location where employee will work ### Recommended Properties - `employmentType`: FULL_TIME, PART_TIME, CONTRACTOR, TEMPORARY, INTERN - `baseSalary`: Salary information - `validThrough`: Expiration date - `identifier`: Internal job ID - `directApply`: Boolean for direct application ### Dynamic Job Posting Component Create `components/schema/job-posting.tsx`: ```tsx import React from 'react'; interface JobPostingSchemaProps { title: string; description: string; datePosted: string; validThrough?: string; employmentType?: string[]; hiringOrganization: { name: string; sameAs?: string; logo?: string; }; jobLocation: { streetAddress?: string; addressLocality: string; addressRegion: string; postalCode: string; addressCountry: string; }; baseSalary?: { currency: string; minValue?: number; maxValue?: number; value?: number; unitText: 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'; }; identifier?: string; isRemote?: boolean; applicantLocationRequirements?: string[]; } export const JobPostingSchema: React.FC = ({ title, description, datePosted, validThrough, employmentType = ['FULL_TIME'], hiringOrganization, jobLocation, baseSalary, identifier, isRemote = false, applicantLocationRequirements }) => { const schemaData = { '@context': 'https://schema.org/', '@type': 'JobPosting', title, description: `

${description}

`, datePosted, validThrough, employmentType, hiringOrganization: { '@type': 'Organization', name: hiringOrganization.name, ...(hiringOrganization.sameAs && { sameAs: hiringOrganization.sameAs }), ...(hiringOrganization.logo && { logo: hiringOrganization.logo }) }, ...(identifier && { identifier: { '@type': 'PropertyValue', name: hiringOrganization.name, value: identifier } }), ...(isRemote && { jobLocationType: 'TELECOMMUTE', ...(applicantLocationRequirements && { applicantLocationRequirements: applicantLocationRequirements.map(country => ({ '@type': 'Country', name: country })) }) }), ...(!isRemote && { jobLocation: { '@type': 'Place', address: { '@type': 'PostalAddress', ...jobLocation } } }), ...(baseSalary && { baseSalary: { '@type': 'MonetaryAmount', currency: baseSalary.currency, value: { '@type': 'QuantitativeValue', ...(baseSalary.value !== undefined && { value: baseSalary.value }), ...(baseSalary.minValue !== undefined && { minValue: baseSalary.minValue }), ...(baseSalary.maxValue !== undefined && { maxValue: baseSalary.maxValue }), unitText: baseSalary.unitText } } }) }; return (