Reading audit run results

Who this is for

Anyone reviewing a single crawl end to end: progress while it runs, score rings when data exists, per-page tables, the interactive report, public landing page controls, and optional intelligence output from the same run.

When to use this screen

Open /audits/<id> from Audits, Reports > Details, a Site detail > Audit history link, or Lead detail > View audit.

Before you start

• Completed runs unlock all tabs. Running runs show progress only. Failed runs show an error card.
• The Intelligence tab needs intelligence enabled on New audit; otherwise the tab shows empty-state copy.
• PDF, HTML, and Markdown downloads, and public URLs, depend on a generated report and your plan.

In the app

1. Under Audit & Analysis, choose Audits.
2. Open a row, or use Reports > Details or a direct audit URL.

Header actions (when not running)

Control	Behaviour
Back arrow	Returns to Audits.
Refresh	Reloads audit metadata from the API.
View Report	Opens <NEXT_PUBLIC_API_URL>/audit/<slug> in a new tab when audit.report exists.
PDF	Downloads audit-<slug>.pdf; toast "PDF downloaded successfully" or an error from getErrorMessage.
Regenerate	Completed runs only. Calls regenerateReport; toast on success or "Failed to regenerate report".
Delete	Confirms "Delete this audit for <domain>? This cannot be undone." then deletes and redirects to Audits; errors toast "Failed to delete audit".

While running, Refresh is hidden. A Progress card shows progressMessage (default "Processing...") and a progress bar with a percentage.

Failed runs

A red Audit Failed card with errorMessage from the API. Use Audits to start a new run after fixing the underlying issue (URL, quota, crawl error).

Score rings (completed)

When scores exist, cards may include SEO, Performance, Security, UX, and (if intelligence merged scores exist) AI Visibility and Brand Health with the subtitles shown in-product.

Intelligence Analysis Layers (when intelFusionUnified is present) lists Technical, Content & Search, AI Citation, UX & Conversion, Brand Communication, Market Listening, and Overall health. Missing layers show a dashed minus ring.

Tabs (completed audits)

Tab	Purpose
Pages (n)	Table of URL, Status (HTTP code badge), Load Time, Size, Resources. Empty: "No page results available".
Interactive	Lazy-loads full page payloads; first open shows "Loading detailed page data..." then InteractiveReportViewer; empty: "No page results to display".
Report	A Report card with the slug, the Public icon (Make Public or Make Private toggle with toasts), View Count, Expires, Open Landing Page, plus HTML (when hasHtml), Markdown, and PDF downloads with matching error toasts. Report Settings below: Brand Name, CTA Button Text, CTA Button URL, Expiration Date (helper "Leave empty for no expiration"), Save Settings.
Intelligence	"Loading intelligence data..." while fetching, Retry on error, or empty: "No intelligence data for this audit. Enable intelligence features when creating an audit to see results here." Otherwise IntelligenceResultsViewer.
Details	Audit Configuration: Max Pages, Max Depth, AI Enabled, AI Vision, Industry, Triggered By, Started, Completed.

Downloads and public sharing

• Public URL pattern: <NEXT_PUBLIC_API_URL>/audit/<slug>. Same target as View Report and Open Landing Page.
• Reports in the sidebar lists completed runs with View, Markdown, PDF, and Details back to this page.

Common pitfalls

Symptom	What to try
Quota or billing block	The message comes from checkBillingUsage on New audit. Confirm Billing & Plans and see Run your first audit.
Download or regenerate error	Read the toast text (server detail or message via getErrorMessage).
Interactive stuck loading	Refresh the audit; check API connectivity.
Intelligence empty	Re-run with Enable intelligence and the relevant toggles on New audit.
Report "No report generated yet"	Wait for completion, or click Regenerate when the status is completed.

Related

• Compare two audits for before-and-after on the same site.
• Custom audit rules for workspace checks evaluated on completed runs.
• Sites and reports for the Reports table and Site detail trends.

API note

Audit fetch, report updates, and downloads are implemented in the REST API (OpenAPI in Docs). This guide sticks to dashboard behaviour.