> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mentionpath.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Site Health: Content and SEO Audits for AI Discoverability
> Audit your site's technical SEO, content quality, and AEO signals. Get page-level scores, a prioritized issues list, and AI-generated fix recommendations.
Site Health audits your website pages for the factors that affect how AI systems discover, understand, and cite your content. Each page receives three separate scores — Technical, Content, and AEO (AI Engine Optimization) — and a consolidated site-wide score. Issues are grouped by severity and category, and each issue comes with a playbook explaining why it matters and how to fix it.
## Understanding the scores
Every audited page receives scores on a 0–100 scale across three categories:
Technical SEO and page performance factors: indexability, canonical URLs, metadata, heading structure, image alt text, page speed metrics (LCP, CLS, INP, FCP, TTFB), and structured data presence.
Content quality signals relevant to AI discoverability: publication dates, author attribution, use of structured formats (FAQs, comparison tables, numbered steps), expert quotes, social proof, and content-to-code ratio.
AI Engine Optimization factors: presence of FAQ schema, structured data for the page type (Article, Product, SoftwareApplication, Organization), breadcrumb schema, and other signals that AI platforms rely on to extract and cite factual information.
The site-wide **Site Health** score is the mean of all page scores across all three categories. It is displayed on the main Site Health page in four score cards (Site Health, Technical, Content, AEO), color-coded by band: green (80+), yellow (60–79), red (below 60).
## Getting started with a sitemap
Before you can audit pages, Mentionpath needs to know which URLs to track. There are two ways to add pages:
Click **Edit Sitemap** → **Refresh Now**. Mentionpath will fetch your sitemap from `yourdomain.com/sitemap.xml` and import all URLs it finds. If your sitemap is at a different path, use **Edit Sitemap** → **Change URL** to enter the correct address.
Click **Edit Sitemap** → **Add Page** and enter a path (e.g. `/blog/my-post`) or a full URL. Mentionpath will resolve the full URL automatically.
Once pages are imported, they appear in the pages table. Pages that have not been audited yet show no scores or issues.
## Running an audit
To audit pages, click **Audit X Pages** in the toolbar. By default this audits all pages in your account. To audit a specific subset:
Check the boxes next to the pages you want to audit. Use the header checkbox to select all visible pages, or use **Select All** to select every page in your account (even those not currently visible in the table).
The button label updates to show how many pages will be audited (e.g. "Audit 12 Pages"). Click it to start the run.
The **Last Audited** column shows "Audit running" with a spinner for pages currently being processed. The site-wide score cards update once the run completes.
You can also retry failed pages using the **Retry failed** option, which appears when one or more pages have a failed audit status.
Audit runs consume page audit credits from your plan. The schedule sheet and the audit button both show your remaining credits for the period. If you exceed your plan's page cap, you will be prompted to upgrade.
## Scheduling automated audits
To keep your scores current without running audits manually, set up a scheduled audit.
Click **Schedule** in the toolbar. If you have pages selected, the schedule will apply only to those pages. If no pages are selected and no schedule exists, the schedule will apply to all pages.
Toggle **Active** on, then choose a cadence: Daily, Every 2 Days, Every 3 Days, Weekly, Biweekly, or Monthly. The sheet shows the estimated pages per month to help you stay within your plan limit.
Click **Save**. The next scheduled run date is shown in the schedule sheet. The Schedule button in the toolbar shows an "On" badge while a schedule is active.
You can save a schedule for a specific subset of pages — for example, your most important landing pages on a daily cadence and your full site on a weekly cadence. Adjust this by selecting different pages before opening the schedule sheet.
## Filtering and sorting pages
The pages table supports several ways to narrow down the list:
* **Search** — Type in the search bar to filter pages by title or URL path.
* **Path filter** — Click the **Page URL** column header to open a path filter popover. Select a path prefix to show only pages under that section of your site (e.g. `/blog/`).
* **Sort** — Click any score column header (Issues, Technical, Content, AEO, Last Audited) to sort. Sorting cycles through ascending, descending, and unsorted.
## Score trend chart
The score trend chart at the top of the Site Health page shows how your site-wide scores have changed over time. Each completed audit creates a data point on the chart.
Use the date range picker in the chart header to zoom into a specific window (presets or custom). Click the metric toggles in the chart to show or hide individual score lines (Site Health, Technical, Content, AEO).
## Page detail view
Click any page row to open that page's detail view. This view shows:
**Score cards** — Technical, Content, and AEO scores for this specific page, color-coded by band.
**Page Information** — Extracted metadata including the page title, H1, meta description, canonical URL, and when the page was last audited.
**Issues list** — All detected issues for this page, organized into three tabs:
Active issues sorted by severity (Critical → High → Medium → Low). Each issue shows a severity badge, the issue message, the detector name, and its category (Technical, Content, or AEO). The score impact badge shows how many points fixing this issue would add to that category's score.
Issues that were either automatically resolved in a re-audit or manually marked as fixed. Shows when each issue was resolved and whether it was auto-resolved or manually fixed.
Issues you have skipped because they do not apply to this page type. Blocked issues are excluded from future audits. You can restore a blocked issue at any time.
Filter open issues by severity (Critical, High, Medium, Low) or by category (Technical, Content, AEO) using the dropdowns in the issue list header.
## Acting on issues
For each open issue, you have three options:
**How to fix** — Opens the playbook slide-over. The playbook contains a plain-language explanation of the issue, why it matters for AI discoverability, and step-by-step guidance on how to fix it. For many issues, Mentionpath can generate an AI-assisted fix — a specific code snippet or content block tailored to your page. For schema-related issues, this is a ready-to-paste JSON-LD block with your actual brand data populated from Domain DNA.
**Mark as fixed** — If you have already fixed the issue on your site, mark it manually. It moves to the Resolved tab. A subsequent audit will verify the fix and either keep it resolved or reopen it if the issue persists.
**Skip issue** — If an issue does not apply to this page type (for example, a "no FAQ content" warning on a contact page), skip it. It moves to the Blocked tab and is excluded from future audits for this page.
Re-running an audit after making fixes is the fastest way to verify your changes and update your scores. Use the **Re-run Audit** button in the top-right of any page detail view to audit that single page immediately.
## Issues view
The **Issues** section (accessible from the Site Health navigation) shows a cross-site view of all open issues grouped by issue type. Each row shows the issue description, severity, category, and how many pages are affected.
Click any issue row to open a detail sheet listing every affected page. From the sheet you can navigate to any individual page's detail view, or click **Re-run All** to re-audit all affected pages at once after making fixes.