> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surgerank.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Site Health Audits: Schema and Crawlability for AI Engines

> SurgeRank audits your site's schema, structure, and crawlability for AI engines and gives you a prioritized fix list to earn more citations.

Traditional SEO audits are built around Google's crawler — its rendering engine, its ranking signals, its tolerance for JavaScript-heavy pages. AI engines work differently: they rely on clean, parseable content and structured data to extract facts they can cite. SurgeRank's Site Health Audit is tuned specifically for the crawlers and parsers used by ChatGPT, Gemini, Perplexity, and the other AI engines that drive modern search. It finds the issues most likely to prevent citations and tells you exactly how to fix them.

## What the audit checks

<AccordionGroup>
  <Accordion title="Schema markup">
    Does each page have appropriate structured data? SurgeRank checks for `Article`, `FAQPage`, `HowTo`, `Organization`, and `Product` schema where relevant. Pages without schema are harder for AI engines to categorise and less likely to be cited with attribution.
  </Accordion>

  <Accordion title="Crawlability">
    Are AI crawlers blocked by your `robots.txt`, `noindex` directives, or prohibitively slow load times? SurgeRank tests against the known user-agent strings used by major AI crawlers (including GPTBot, Google-Extended, and PerplexityBot) and flags any directive that prevents them from accessing your content.
  </Accordion>

  <Accordion title="Content structure">
    Are headings, paragraphs, and lists organised so an AI engine can extract discrete, attributable facts? The audit checks heading hierarchy, paragraph length, and whether key claims are surfaced early in sections rather than buried in long prose blocks.
  </Accordion>

  <Accordion title="Entity clarity">
    Is your brand name, product name, and category consistent throughout the site? Inconsistent entity naming (for example, using "SurgeRank", "Surge Rank", and "SR" interchangeably) confuses AI engines and reduces citation confidence. The audit flags inconsistencies across your crawled pages.
  </Accordion>

  <Accordion title="Freshness signals">
    Does your content clearly show when it was published and when it was last updated? AI engines weight freshness heavily for certain query types. The audit checks for visible publication dates, `datePublished` and `dateModified` in schema, and `Last-Modified` HTTP headers.
  </Accordion>

  <Accordion title="Internal linking">
    Do your most important pages receive strong internal links from the rest of the site? AI crawlers follow internal links to discover and re-crawl content. Pages that are poorly linked internally are crawled less frequently and cited less often. The audit identifies high-value pages with weak internal link profiles.
  </Accordion>
</AccordionGroup>

## Running an audit

To start an audit, open the **Audit** tab and click **Run audit**. SurgeRank will crawl your site starting from your root domain. A full crawl typically completes within **15 minutes** for sites under 1,000 pages; larger sites may take longer. You'll receive an in-app notification and an optional email when the audit is complete.

You can limit the crawl to a specific subdirectory (for example, `/blog/` only) using the **Crawl scope** setting if you want faster results for a particular section of your site.

## Reading audit results

Every issue the audit finds is assigned one of three priority levels:

| Priority   | Meaning                                                                    |
| ---------- | -------------------------------------------------------------------------- |
| **High**   | Directly blocks or significantly suppresses AI citations. Fix immediately. |
| **Medium** | Reduces citation frequency or quality. Fix in the current sprint.          |
| **Low**    | Minor signal improvements. Address when capacity allows.                   |

The default view sorts all issues by priority so the most impactful fixes are always at the top. You can filter by priority level, issue type (schema, crawlability, structure, etc.), or page URL. A summary scorecard at the top of the results page shows how many High, Medium, and Low issues were found and how those numbers compare to your previous audit.

## Fixing issues

Every finding in the audit results includes three things:

1. **Plain-English description** — what the issue is and why it matters for AI citations.
2. **Specific fix recommendation** — exactly what to change, including which file, CMS setting, or page element to update.
3. **Code snippet** (for schema issues) — a ready-to-use JSON-LD block you can paste directly into your CMS's `<head>` section or schema field.

For crawlability issues, SurgeRank shows you the exact `robots.txt` rule or HTTP header causing the block and provides a corrected version you can implement immediately.

## Re-auditing

After implementing fixes, re-run the audit to confirm that the issues are resolved. Click **Run audit** again from the Audit tab at any time. SurgeRank will also **auto-schedule a full audit once per month** so your site health score stays current even if you don't trigger a manual re-run.

Historical audit results are saved so you can track your site health score over time and demonstrate progress to stakeholders.

<Warning>
  If AI crawlers are blocked in your `robots.txt`, fix this before making any other change. No crawl means no citation, regardless of how good your content and schema are. This is the single highest-impact fix on the entire audit — treat it as a hard blocker.
</Warning>