How Everything Works
Learn about the system architecture, report generation process, organization model, and core functionality.
On this page
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:
- Using the Dashboard — Navigate the dashboard, manage websites, and run monthly reports.
- Using Manually Generated Reports — Generate, view, and share on-demand single-URL reports (one page per report).
- Understanding Your Report — Read scores, categories, errors, and export (PDF/CSV).
- Using Monthly Site Reports — Aggregated site reports, findings by page, competitor comparison (Enterprise), and individual page reports. Trend charts are on the dashboard.
- How the Site Behaves — Authentication, workspaces, permissions, limits, and a full "How to Use" walkthrough.
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