Getting Started
Run your first audit
The New audit form. URL, crawl limits, billing checks, AI add-ons, and intelligence agents.
Last updated 2026-07-07
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. - If your monthly audit allowance is spent, a run can draw on a report credit instead. A credit-funded run is a standard report (AI, Vision, and Intelligence off for that run). With no allowance and no credits you are prompted to buy credits or upgrade. See Billing and plans.
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. The choices run from 1 up to your plan's cap: Free up to 10, Pro up to 50, Enterprise up to 500.
- 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.
Google data (optional)
When intelligence is on and you have typed a URL, a Google data panel appears. It shows whether that domain's site already has Search Console and Analytics (GA4) connected. Choose Connect Google data (or Manage connections) to open the site's Connections page in a new tab; this form keeps its state, so you can connect there, return, and run the audit. A first audit of a freshly connected site then uses its real search and traffic data. See Per-site Google connections.
If the server has no Google OAuth client configured, the panel says so instead.
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. |
| "Needs credits" (HTTP 402) | Monthly allowance spent and no report credits. Use Buy report credits or View plans and upgrade. |
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.
- Per-site Google connections to feed GA4 and Search Console data into the run.
- Billing and plans for report credits and the needs-credits flow.