SurfaceScore

Help & Documentation

Everything you need to know about using SurfaceScore effectively.

Getting Started

  1. Enter your URL - Type or paste your website URL in the input field
  2. Click Analyze - Hit the "Analyze Website" button to start the compatibility check
  3. Review Results - Get detailed insights across four key areas
  4. Implement Changes - Follow our recommendations to improve compatibility

Understanding Your Scores

📖 Safari Reader Mode (0-100)

Measures how well your content displays in Safari's distraction-free reading mode. Key factors include:

  • Semantic HTML structure
  • Clear article content identification
  • Proper heading hierarchy
  • Image alt text and captions

🤖 Apple Intelligence (0-100)

Evaluates content suitability for AI summarization and understanding. Factors include:

  • Content structure and clarity
  • Key topics definition
  • Content-to-noise ratio
  • Semantic markup quality

📊 Structured Data (0-100)

Analyzes Schema.org markup and structured data implementation:

  • Valid JSON-LD or microdata
  • Article/content metadata
  • Publication information
  • Author and organization details

♿ WCAG 2.1 Compliance (0-100)

Measures accessibility compliance using industry standards:

  • Color contrast ratios (AA level)
  • ARIA labels and roles
  • Keyboard navigation support
  • Screen reader compatibility

Common Issues & Solutions

Low Reader Mode Score

  • Use semantic HTML tags (article, section, header, main)
  • Implement proper heading hierarchy (H1, H2, H3...)
  • Add alt text to all images
  • Structure content with clear paragraphs

Poor Apple Intelligence Score

  • Write clear, focused content
  • Use descriptive headings and subheadings
  • Add Schema.org markup for content understanding
  • Minimize distracting elements

Missing Structured Data

  • Implement JSON-LD structured data
  • Add Article or WebPage schema
  • Include author and publication dates
  • Validate markup with Google's Structured Data Testing Tool

Best Practices

  • Test regularly - Check your site after major content or design changes
  • Focus on content - Prioritize clear, well-structured content over decoration
  • Use semantic HTML - Proper HTML structure benefits all scoring areas
  • Implement gradually - Start with high-priority recommendations
  • Validate changes - Re-test after implementing improvements

Troubleshooting

Analysis Failed

If the analysis doesn't complete:

  • Ensure the URL is publicly accessible
  • Check for CORS restrictions
  • Try again with a different page
  • Make sure JavaScript is enabled

Unexpected Scores

If scores seem incorrect:

  • Review the detailed recommendations
  • Check that the page loaded completely
  • Consider dynamic content that may not be analyzed
  • Test with a simpler page structure first

Need More Help?

Can't find what you're looking for? We're here to help: