Skip to content
Docs

Running an audit

Start a RankX AI Website Audit from Run Audit as a Full Site Scan or Specific Pages check. It runs in the background; then read the issues before the score.

To run a RankX AI Website Audit, open Website Audit, click Run Audit and choose a Full Site Scan or a Specific Pages check. The audit runs in the background, and when it finishes the report shows a score, the issues by severity and the pages each one affects.

You can also start an audit from an AI assistant over MCP.

How do I start an audit?

Open Run Audit

Go to Website Audit for the Website and click Run Audit. The dialog has two tabs, Full Site Scan and Specific Pages.

Choose what to audit

On Full Site Scan, pick a page count. On Specific Pages, paste up to 50 URLs, one per line. The dialog shows the price before you start.

Start it and come back

The audit is queued and runs in the background. You can leave the screen; the banner above the report shows when the new audit has finished.

Which audit mode should I use?

Use a Full Site Scan for a health check of the whole site, and Specific Pages to re-check pages you have just changed.

ModeWhat it doesWhen to use it
Full Site ScanCrawls your site, starting with your most important pages, up to the page count you choose, with a homepage performance checkThe first audit on a new Website, and the periodic health check
Specific PagesAudits the exact URLs you list in a real browserRe-checking pages after a fix, or answering checks only a browser can assess
Quick check (over MCP)Audits one pageConfirming a single fix from an assistant

Specific Pages is not just a narrower crawl. It renders each page in a browser, so it can assess checks the plain crawl marks Not checked. See what "a check did not run" means.

The first time you run an audit, or when the Website has an Audit start URL saved in its settings, the dialog opens on Specific Pages with that URL already filled in.

How do scheduled audits work?

A scheduled audit re-checks your homepage and the site-wide checks, such as your sitemap, robots.txt and certificate, on a cadence you choose. It is switched on by default, so your score and issues are tracked over time without you starting anything.

The switch is Scheduled site audits in Settings → Automation. The fastest cadence is your plan's, or every 7 days during the trial, whichever is slower. Turning it off stops the scheduled checks and leaves manual audits as they are.

How long does an audit take?

Most audits take minutes, and the time grows with the page count. A hundred pages on a fast host and a hundred pages behind a slow one are different jobs, so there is no useful average.

From an assistant, poll rather than wait. start_site_audit returns a job id at once, and get_site_audit_status reports when the audit is complete. An assistant that reads the start response as the result will report "no issues found" straight away, which is the most common mistake with this tool.

How do I read the report?

Read the issues before the score: the score is a summary, and the issues are the work.

Start with severity. Issues first, then warnings. The affected-page count on each tells you whether it is one page or the whole site.

Read the Not checked list. A long Not checked list usually has one cause, most often that the audit ran on the path that cannot assess those checks. It is a list of questions this audit did not answer, not a list of faults.

Check the page count against what you expect. If your site has 400 pages and the crawl reached 40, the report describes those 40. See page selection and cost.

Site-wide findings are never diluted. A missing sitemap or robots.txt takes its full weight whatever the number of pages crawled, so a real site-wide problem stays visible.

Which audit does the report show?

The report always shows the most recent completed audit. A crawl that is still running does not partly overwrite it, and a crawl that failed does not replace a good report with an empty one.

So if the report looks unchanged after you started a new audit, the new one has not finished yet, and the banner says so.

Can I export the report?

Yes. The Export menu on the Website Audit screen has two options.

  • Download PDF opens your browser's print dialog, where you choose Save as PDF.
  • Download data saves a JSON file of every finding, for developers.

How do I turn findings into work?

Each finding can become a task, and on a connected WordPress site some fixes can be prepared and applied from that task.

Create a task. Click Create task on a finding to put it on the Tasks board. RankX AI keeps one open task per issue, ordered by opportunity rather than by category, and the task keeps a copy of the finding, so it survives the next audit.

Apply the fix. On a task for a connected WordPress site, Prepare the change drafts the edit and writes nothing to your site.

You see the exact before and after, and Apply to my site is a separate, deliberate step. See the WordPress integration.

What does the Task Creation Assistant do?

The Task Creation Assistant turns a finding into a properly written task: why it matters, the recommended approach, the steps, when it is done and how to check it worked. It spends credits, and its button shows the price before you click. See the Task Creation Assistant.

Can an AI assistant run the audit?

Yes. Three MCP tools run the whole loop: start_site_audit starts a full or quick audit, get_site_audit_status reports progress, and get_site_audit_issues reads the findings.

Start a site audit on my main website. Tell me my credit balance and the cost first, then poll until it finishes and give me the issues grouped by severity, with the Not checked ones listed separately.

See the tool reference for every input, including the page count an assistant may request.

Where to go next

Questions

How long does a Website Audit take?

Usually minutes, and longer for a larger page count or a slow host. The report keeps showing your last completed audit until the new one finishes.

Why does my report still show the old audit?

The new audit has not finished yet. RankX AI reports only the most recent completed audit, so a running or failed crawl never replaces a good report.

Do scheduled audits crawl my whole site?

No. A scheduled audit re-checks your homepage and the site-wide checks on the cadence you set. Run a Full Site Scan whenever you want the whole site audited.

Who can apply a fix from an audit finding?

Your own team. Preparing and applying a change to a connected WordPress site is a staff action, and nothing is written until someone clicks Apply to my site.

Last updated

Cookie settings

Choose which cookies we can use. You can change this at any time from “Cookie settings” in the footer.

Essential

Security, bot protection and remembering your choice. The site needs them to run, and they do not identify you. Always on.

Google Analytics cookies that tell us which pages are read and which links are followed, so we can improve them. Off until you switch it on.

Tells advertisers when their advert led to your visit. Includes the Meta (Facebook) pixel and the LinkedIn Insight Tag, which set cookies on this domain (LinkedIn also on linkedin.com) and can be told if you later start a trial.

More in the cookie policy and the privacy policy.