Documentation
Everything you need to get the most out of Web Audit Suite.
Getting Started
Web Audit Suite analyzes your website across 18 dimensions — from security headers and accessibility to AI readiness and CSS quality. Here is how to get up and running in under a minute.
1. Create an Account
2. Choose Your Plan
3. Run Your First Audit
Running an Audit
URL Input
Enter any URL in the audit page input field. The URL is automatically normalized: whitespace is trimmed, trailing slashes are stripped, and https:// is prepended if no protocol is provided. The URL must contain a valid hostname with a dot (e.g., example.com).
Scan Phases
Each audit runs in two phases. During the core phase, 7 execution units run 17 analyzers in parallel. Once core completes, the PageSpeed phase calls the Google PageSpeed Insights API separately.
| Phase | What Happens | Poll Interval | Duration |
|---|---|---|---|
Core | 7 execution units running 17 analyzers in parallel | Every 2 seconds | Typically 10-30 seconds |
PageSpeed | Google PageSpeed Insights analysis | Every 5 seconds | Up to 90 seconds (countdown shown) |
Complete | All analyzers finished successfully | Polling stops | — |
Progress Indicators
During the core phase, a progress bar shows "X of Y analyzers complete" and updates every 2 seconds. During the PageSpeed phase, a 90-second countdown timer is displayed. Results populate progressively — tabs become available as each analyzer finishes, so you can start reviewing before the scan is fully done.
Cached Results
Results are saved to your browser's local storage (up to 10 entries, oldest evicted first). If you revisit the same URL, cached results load instantly with no network request. Refreshing the page bypasses the cache to run a fresh scan.
Cooldown Period
There is a 60-second cooldown between scans to respect Google PageSpeed API rate limits. If you try to start a new scan within 60 seconds, you will see a brief cooldown message.
Interrupted Scans & Recovery
If the scan stalls (no server heartbeat for 45 seconds), a recovery banner appears with three options: Accept Partial Results to view whatever data was collected, Retry Scan to start a fresh scan, or Abandon Scan to discard and return to the input. If 5 consecutive network errors occur during polling, a "Retry Connection" button appears so you can resume without losing progress.
Understanding Your Results
Audit results are organized into 8 tabs. Each tab populates progressively as its analyzers complete — skeleton placeholders appear while data is loading.
Overview
Site metadata (title, description, Open Graph tags, favicon), hosting information (server, CDN detection), and the detected technology stack grouped by category.
PageSpeed
Four Lighthouse scores (Performance, Accessibility, Best Practices, SEO), Core Web Vitals (FCP, LCP, TBT, CLS, Speed Index), top optimization opportunities, diagnostics, and a final screenshot of the rendered page.
Accessibility
Two-lens view: User Experience score from Google PageSpeed and a Code Structure analysis covering ARIA usage, semantic HTML, heading hierarchy, form labels, image alt text, color contrast, keyboard navigation, and WCAG level determination. Issues are categorized by severity: Critical, Serious, Moderate, and Minor.
SEO
Composite SEO score (0-100) broken into 8 weighted components: Basic Metadata (20 pts), Link Health (15 pts), Canonical Tags (15 pts), Metadata Consistency (15 pts), Redirect Management (10 pts), Crawling & Indexing (10 pts), Social Media Tags (10 pts), and Schema Markup (5 pts). Each component is expandable with specific recommendations.
AI Readiness
GEO/AEO score measuring how well your site is optimized for AI citation. Checks structured data (JSON-LD, FAQ/HowTo schema), heading hierarchy, question-answer patterns, reading level, word count, and bot crawlability (GPTBot, ClaudeBot, Google-Extended).
Security
Score gauge based on 7 security headers: Content-Security-Policy, Strict-Transport-Security, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, and X-XSS-Protection. Each header shows its status, risk level, and a recommendation if missing or misconfigured.
CSS
CSS quality score with file metrics (count, total size, minification status), complexity analysis (specificity, nesting depth, !important usage), issues by severity, detected frameworks (Bootstrap, Tailwind, etc.), and design token extraction (colors, fonts, spacing, breakpoints).
Hosting
Full SSL certificate details including issuer, validity dates, days remaining (color-coded: red if under 30 days, yellow under 90, green otherwise), DNS records table (A, AAAA, MX, TXT, NS, CNAME, SOA), and server information.
Scores & Methodology
Overall Score
The overall score is the average of four Google PageSpeed Insights scores: (Performance + Accessibility + Best Practices + SEO) / 4. This requires the PageSpeed phase to complete. If PageSpeed fails or times out, the overall score is not available.
Color Thresholds
All scores follow the Google PageSpeed Insights color convention:
Composite SEO Score (100 Points)
The SEO tab displays a composite score built from 8 weighted components. Each component draws from one or more analyzer results.
| Component | Max Points | How It's Calculated |
|---|---|---|
| Basic Metadata | 20 | Title presence and length (optimal 50-60 chars), meta description presence and length (optimal 150-160 chars) |
| Link Health | 15 | Scaled from broken links analyzer score (score x 15/100) |
| Canonical Tags | 15 | Scaled from canonical tags analyzer score (score x 15/100) |
| Metadata Consistency | 15 | Scaled from metadata consistency analyzer score (score x 15/100) |
| Redirect Management | 10 | Scaled from redirect check analyzer score (score x 10/100) |
| Crawling & Indexing | 10 | Sitemap presence (-5 if missing, -1 to -3 per issue), robots.txt presence (-2 if missing, -1 to -3 per error) |
| Social Media Tags | 10 | OG Title (-3), OG Description (-3), OG Image (-2), OG URL/Type (-2 if both missing) |
| Schema Markup | 5 | 0 if no JSON-LD detected, 5 if present |
Individual Analyzer Scores
Each analyzer produces its own 0-100 score with specific deduction rules. See the Analyzer Reference section below for the scoring formula of each analyzer.
Analyzer Reference
Web Audit Suite runs 18 analyzers organized into 8 execution units. Expand any analyzer below to see what it checks, how it scores, and tips to improve.
Reports & Exports
PDF Reports
After running an audit, click "Create Report" in the export bar. The report customization page lets you toggle up to 8 sections (Overview, PageSpeed, SEO, Security, Hosting, CSS, Accessibility, GEO) and preview before generating the PDF.
White-Label Branding
Available on Pro and Agency plans. Customize your reports with your own agency name, client name, uploaded logo, color scheme, and custom footer text. Toggle whether to include improvement recommendations.
JSON Export
Agency plan only. Export the full audit as a structured JSON file (schema version 1.1.0) containing all scores, tab data, and metadata. The file is named website-analysis-{domain}-{date}.json.
Availability by Plan
| Feature | Starter | Pro | Agency |
|---|---|---|---|
| PDF Report Generation | Included | Included | Included |
| Content Section Selection (8 toggleable sections) | Included | Included | Included |
| White-Label Branding (agency name, logo, colors, footer) | — | Included | Included |
| JSON Export (schema v1.1.0) | — | — | Included |
| REST API Access | — | — | Included |
See Plans & Pricing for full details.
Plans & Pricing
Three plans to match your workflow. Starter and Pro include a 7-day free trial with full access to all features in their tier.
| Feature | Starter $29 | Pro $59 | Agency $119 |
|---|---|---|---|
| Price | $29/mo | $59/mo | $119/mo |
| Free Trial | 7 days | 7 days | — |
| Audits per Month | 20 | 50 | 75 |
| All Analysis Tabs | Yes | Yes | Yes |
| PDF Report Generation | Yes | Yes | Yes |
| White-Label Branding | — | Yes | Yes |
| JSON Export | — | — | Yes |
| REST API Access | — | — | Yes |
| Max API Keys | — | — | 5 |
| API Burst Rate | — | — | 2/min |
| API Daily Limit | — | — | 25/day |
Account Management
Manage your profile, subscription, and usage from the Account page.
Profile
Your email address is displayed as read-only. To change your email, contact support.
Subscription
View your current tier, subscription status (active, trialing), and trial end date if applicable. Click "Manage Subscription" to open the Stripe customer portal where you can upgrade, downgrade, or cancel.
Usage Tracking
A progress bar shows your current month's scan usage against your plan limit (e.g., 12 of 20 audits used). Usage resets at the start of each billing cycle.
Password & Security
Change your password from the account page (minimum 12 characters). If you forget your password, use the password reset flow — a recovery link is sent to your email.
Account Deletion
To permanently delete your account, type DELETE as confirmation. This action is irreversible and removes all your data.
API Overview
The REST API is available on the Agency plan. It lets you run audits programmatically and integrate results into your own tools and workflows.
Quick Reference
https://webauditsuite.com/api/v1Authorization: Bearer was_your_api_keyPOST /api/v1/auditRate Limits
The monthly API limit shares the same pool as your scan quota (75 total for Agency).
Troubleshooting
Timing & Limits Reference
| Rule | Value |
|---|---|
| Cooldown between scans | 60 seconds |
| PageSpeed analysis timeout | 90 seconds |
| Orchestrator max duration | 300 seconds |
| Stale session threshold | 45 seconds without heartbeat |
| Network error pause | After 5 consecutive failures |
| Core phase poll interval | 2 seconds |
| PSI phase poll interval | 5 seconds |
| Max links checked per scan | 50 |
| Max pages crawled per scan | 20 |
| Max redirect hops followed | 5 |
| Oversized image threshold | 300KB |
| Cache max entries | 10 (LRU eviction) |
| Session retention | 7 days |