Getting Started
Run your first audit
The New audit form. URL, crawl limits, billing checks, AI add-ons, and intelligence agents.
Last updated 2026-05-29
In the app
Who this is for
Operators running a crawl for the first time, or enabling AI and Intelligence features on a new workspace.
When to use this screen
Use New audit when you need a fresh /audits/<id> run with explicit Max pages, Max depth, and optional intelligence agents.
Before you start
- Have a public URL. Password-protected sites are not supported (see the Help Centre FAQ).
- Confirm Billing quotas. The form calls
checkBillingUsagebeforestartAuditfor audit, ai, vision, intelligence, and an extra path when competitor analysis is enabled.
In the app
- Under Audit & Analysis, choose Audits.
- Open New Audit (or go to
/audits/new). - The page title is New Audit with subtitle "Run a comprehensive website audit".
Form fields
- URL. Full address, placeholder
https://example.com. Includinghttps://is best practice. - Max pages. 1 (Quick), 5, 10, 20, or 50. Plan caps still apply.
- Max depth. 1 to 5 link levels.
- Industry (optional). Free text; passed to the backend when supported.
AI analysis
- AI analysis. Richer commentary and summaries (plan-gated).
- Vision UX analysis. Screenshot UX review; enabled only when AI analysis is on.
Intelligence features
Enable intelligence runs agents alongside the crawl. When on:
- Reporting mode. Standard, Marketing, Brand, or Competitive.
- Toggles for citation, brand, market listening, and competitor analysis. Several may switch on together when intelligence is first enabled.
After you start
On success the page redirects to /audits/<id> while the run progresses. See Reading audit run results.
Common pitfalls
| Symptom | Cause and next step |
|---|---|
| URL is required | Submit blocked until URL is non-empty. |
Quota banner (quotaWarning) | Server reason from checkBillingUsage. Upgrade, disable AI or intelligence, or wait for the next period. |
| Network or API error | Toast or inline error from startAudit. Verify NEXT_PUBLIC_API_URL under Settings > Environment. |
Quotas (published plans)
- Free. 5 audits per month, 10 pages per audit.
- Pro. 50 audits per month, 50 pages per audit.
- Enterprise. Unlimited audits, 500 pages per audit.
Confirm live usage on Billing (the subtitle shows "audits used" when returned by getBillingStatus).
Related
- Sites and reports.
- Integrations (Slack, Discord, PlusVibe, and webhooks) for completion notifications.