Skip to main content
Back to Resources
⚙️

How Everything Works

Learn about the system architecture, report generation process, organization model, and core functionality.

System Architecture

Website Health uses an organization-based model where users belong to workspaces (organizations) that share subscriptions, reports, and settings. This collaborative approach allows teams to work together seamlessly while maintaining clear boundaries between different projects or clients.

All subscriptions, reports, and website configurations are tied to organizations, not individual users. This means when you subscribe to a plan, the entire organization gains access to those features, making it easy to manage team access and billing.

Report Generation

Reports are generated asynchronously using a comprehensive analysis engine that checks accessibility, SEO, performance, and security metrics. When you submit a URL for analysis, our system performs a multi-stage analysis:

1. Content Fetching & Parsing

The system fetches the page HTML, CSS, and JavaScript, then parses the DOM structure to understand the page layout and content.

2. Accessibility Analysis

Checks for ARIA landmarks, image alt tags, color contrast ratios, semantic HTML structure, form labels, and mobile viewport configuration. For Pro/Enterprise plans, this includes rendered checks using browser automation.

3. SEO Evaluation

Analyzes meta tags, page titles, meta descriptions, headings structure, canonical URLs, link quality, readability, spelling, and contact/trust signals.

4. Performance Metrics

Measures server response time, checks for lazy loading implementation, and evaluates resource optimization. Pro/Enterprise plans include Core Web Vitals (LCP, CLS, INP, TTFB) via Lighthouse analysis.

5. Security Scanning

For Enterprise plans, analyzes SSL/TLS certificate validity, protocol versions, cipher hygiene, and security headers (HSTS, CSP, X-Frame-Options, etc.).

6. AI Insights (Pro/Enterprise)

Generates AI-powered insights on layout, content quality, UX, and accessibility improvements.

Processing typically takes 1-3 minutes depending on page complexity and your plan tier. You'll receive an email notification when your report is ready. Reports are processed in the background, so you don't need to wait on the page.

Organization Model

Users can be members of multiple organizations with different roles:

Viewer

Can only view reports and dashboard data

Editor

Can generate reports and manage websites

Admin

Can manage members and organization settings

Superadmin

Has full control over the organization

Report Types

The system supports manual (on-demand) reports, monthly automated reports, and competitor comparison:

Single-URL Reports (Manually Generated)

Analyze individual URLs on-demand. Perfect for testing specific pages, checking fixes, or analyzing competitor pages.

  • Generated on-demand by users
  • Analyze one URL at a time
  • Expire after 90 days for all plans
  • Can be private or public
  • Subject to daily usage limits

Monthly Automated Reports

Automated reports that analyze multiple pages from a website's sitemap or crawl. Scheduled monthly (keyed to billing periods) or triggered with "Run Now" to track improvements over time.

  • Automatically generated on a schedule or manually triggered ("Run Now")
  • Scan multiple URLs (up to plan limit: Basic=100, Pro=250, Enterprise=1,000)
  • Never expire; always private
  • Generate per-URL child reports plus a combined aggregated report
  • Include AI-generated summaries (Pro/Enterprise only)
  • Available for Basic, Pro, and Enterprise plans (not Free)

Competitor Reports (Enterprise)

Compare your website against up to 5 competitor URLs. Competitor comparison is included in monthly reports and shows how your site compares across metrics.

  • Add competitor URLs in the dashboard under each website's settings (all paid plans)
  • Competitor scanning and reports included in monthly automated runs (Enterprise only)
  • Enterprise only

Plan Features

Different subscription plans unlock different features and limits:

Free Plan

  • 3 reports per day
  • Single-URL analysis only (1 URL per report)
  • 1 website per workspace
  • Basic SEO and accessibility analysis
  • 90-day report storage
  • No monthly automated reports
  • No white-label reports
  • No advanced features (Core Web Vitals, rendered checks, AI insights)

Basic Plan

  • 100 reports per day
  • Multi-page analysis (up to 100 URLs per monthly scan)
  • Unlimited websites (based on website limit selection, up to 100)
  • Monthly automated reports
  • 90-day storage for single-URL reports
  • No white-label reports
  • No advanced features (Core Web Vitals, rendered checks, AI insights)

Pro Plan

  • 100 reports per day
  • Multi-page analysis (up to 250 URLs per monthly scan)
  • Unlimited websites (based on website limit selection, up to 100)
  • All Basic features
  • Your workspace logo on PDF and shared web reports (CSV and emails use default branding)
  • Advanced features: Core Web Vitals, rendered checks, AI insights
  • Partial WCAG 2.1 AA compliance audit

Enterprise Plan

  • 100 reports per day
  • Multi-page analysis (up to 1,000 URLs per monthly scan)
  • Unlimited websites (based on website limit selection, up to 100)
  • All Pro features
  • Security Suite: SSL/TLS analysis, security headers scanning
  • Priority support
  • Custom integrations available

Data Storage & Privacy

Single-URL reports are stored online for 90 days for all plans; after that the link expires. Monthly automated reports never expire. Download PDF or CSV to keep a permanent copy of any report.

Report Expiration

  • Single-URL (manual) reports: Expire after 90 days for all plans
  • Monthly reports: Never expire; retained while your subscription is active
  • Expired reports show a warning but can still be viewed
  • We recommend downloading PDF/CSV copies for permanent records

Privacy Settings

  • Private Reports: Only workspace members can view. Cannot be emailed outside workspace except via PDF/CSV download
  • Public Reports: Anyone with the URL can view. Perfect for sharing with clients or stakeholders
  • Monthly Reports: Always private
  • Privacy settings can be toggled at any time for manual reports (workspace admins)

Archiving When You Downgrade

If your plan's website limit decreases (e.g. after a downgrade), you choose which websites to archive. When downgrading to the Free plan, all websites must be archived (Free has 0 active slots). Archived websites and their monthly report data remain viewable until you delete or restore them. You can restore a website when you have an available slot (e.g. after resubscribing). On Free, you still have access to manually generated reports (3 per day).

How to Use the Product

For step-by-step instructions on using Website Health, see our tutorials and the behavior guide:

From the home page you can run a free single-URL report without logging in. To manage multiple websites, monthly reports, and teams, log in and use the dashboard.

Report Categories & Scores

Each report analyzes your page across multiple categories, each with a score from 0-100%. The overall health score is a weighted average of all category scores. Categories include:

Accessibility

ARIA Landmarks, Image Alt Tags, Color Contrast, Semantic HTML, Form Labels, Mobile Viewport Analysis

SEO

Meta Tags, Page Title Quality, Meta Description Quality, Headings Structure, Canonical URL, Link Quality

Content Quality

Readability, Spelling & Professionalism, Contact & Trust Signals

Performance

Server Response Time, Lazy Loading Signals, Core Web Vitals (Pro/Enterprise)

Technical

Broken Links, Favicon, Mobile Configuration, Input Types

Security (Enterprise)

SSL/TLS Certificate Analysis, Security Headers, TLS Protocol & Cipher Hygiene

Last reviewed: 2026-05-11