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

# Site-wide Audit Tool: Schema Health Across Your Domain

> Scan every page of a domain for structured data gaps, syntax errors, and missed Rich Result opportunities, then export a PDF report for clients.

The Site-wide Audit Tool scans every page of a domain and produces a structured data health report for the entire site. Instead of checking pages one by one, you enter a domain, start the audit, and get back a per-URL breakdown showing what schema is present, what's missing, where errors exist, and which pages represent the biggest opportunities for structured data improvement.

<Warning>
  The Site-wide Audit Tool is an **Agency plan** feature (\$99/mo). Single-page auditing is available to all users as a free tool from the dashboard. To unlock full site audits with PDF export, upgrade to the Agency plan.
</Warning>

## How to run a site audit

<Steps>
  <Step title="Open the Audit Tool">
    From the dashboard, click **Audit** in the left sidebar. The audit interface loads with a URL input and a mode selector.
  </Step>

  <Step title="Enter your sitemap URL">
    Paste the sitemap URL for the domain you want to audit—for example, `https://example.com/sitemap.xml`. SchemaGen parses the sitemap XML, extracts all page URLs, and queues them for analysis. The audit covers up to 20 URLs from the sitemap per run.

    <Tip>
      Use your root sitemap if your site has multiple sitemaps. If your site uses a sitemap index file, link to the main index and SchemaGen will follow the references. For the most complete picture, make sure your sitemap is up to date before running an audit.
    </Tip>
  </Step>

  <Step title="Start the audit">
    Click **Run Audit**. SchemaGen begins crawling and analyzing each URL in the queue. The audit runs page by page; you can see progress update in real time as each URL completes.
  </Step>

  <Step title="Review the per-URL report">
    When the audit finishes, the results appear as a table with one row per audited URL. Each row shows the page URL, its structured data health score, detected schema types, issues found, and AI-generated recommendations.
  </Step>

  <Step title="Drill into individual pages">
    Click any URL in the results table to open its detailed page report. Here you can see every schema issue on that page, the specific fields causing problems, and suggested fixes. You can also launch the Schema Builder from this view, pre-populated with the corrected schema for that page.
  </Step>

  <Step title="Export the PDF report">
    Click **Export PDF** to generate a shareable report covering the entire audit. The PDF includes the per-URL health scores, issue summaries, and AI recommendations formatted for client presentation.
  </Step>
</Steps>

## What the audit report covers

Each page in the audit results includes the following information:

<CardGroup cols={2}>
  <Card title="Schema health score" icon="gauge">
    A score for each page reflecting how complete and error-free its structured data is. Pages with no schema score lowest; pages with valid, Google-eligible schema score highest.
  </Card>

  <Card title="Detected schema types" icon="tags">
    Every `@type` found on the page, including schemas already deployed through SchemaGen and any existing JSON-LD in the page source.
  </Card>

  <Card title="Syntax errors" icon="triangle-exclamation">
    Structural problems with existing schema markup that prevent search engines from reading it correctly—missing required fields, invalid property types, malformed JSON.
  </Card>

  <Card title="Missing schema opportunities" icon="lightbulb">
    Pages where structured data could be added but isn't. The audit identifies the schema type that would be most appropriate for each page based on its content.
  </Card>
</CardGroup>

## AI deep audit

For each page, the audit also runs an AI deep audit that generates a plain-language recommendation specific to that page's content and existing schema state. This goes beyond generic validation rules to provide context-aware guidance—for example, identifying that a product page has a `Product` schema but is missing `aggregateRating` despite having visible review content, or that a FAQ section is present in the page body but has no corresponding `FAQPage` schema.

These recommendations are written in language your clients can understand, making them useful to include directly in the exported PDF report.

## PDF export and client deliverables

The PDF report is designed to be shared with clients or stakeholders who don't have access to the SchemaGen dashboard. It includes:

* An executive summary with overall domain schema health
* A page-by-page breakdown with scores and top issues
* AI-generated recommendations per page
* Your agency branding (with white-label settings configured in **Account → White Label**)

To export, click **Export PDF** from the audit results view. The file generates and downloads automatically. Agency plans include white-label deliverables, meaning you can replace SchemaGen's branding with your own agency name and logo in the report.

## Audit limitations and error states

* **Site blocked:** If the domain blocks automated crawlers, the audit cannot retrieve page content. The affected URLs appear as failed in the results table with a `site_unsupported` error. For sites you manage, check your `robots.txt` to ensure SchemaGen's crawler is not disallowed.
* **Timeout:** Pages that are very slow to load may time out during crawling. These appear as failed results. Try re-running the audit during off-peak hours if a significant number of pages are timing out.
* **20-page limit per run:** Each audit run processes up to 20 URLs from the sitemap. For large sites, prioritize by submitting a focused sitemap (for example, just your product pages or blog posts) for targeted audits.