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

# SEO Audits

> Run automated technical SEO crawls on your websites, score your SEO health, and track improvements over time. This functionality is ideal for branding websites (Wordpress, Wix, Webflow, etc.) - if you have regular web app - ensure that your pages have SEO defined metadata (NextJS apps handle this easier than say - React)

## Overview

SEO Audits crawl your website and analyze it for technical issues that affect search engine performance. Each audit produces an overall health score, a categorized list of issues by severity, and actionable recommendations to fix them.

Go to **SEO → Audits** to run your first audit or view past results.

***

## Running an Audit

1. Select the **Digital Experience** (website) you want to crawl from the dropdown
2. Click **Run Audit**
3. The audit runs asynchronously — a progress bar tracks completion in real time

<Info>
  Audits crawl publicly accessible pages only. Pages behind authentication, paywalls, or VPNs will not be included in the crawl.
</Info>

The audit typically completes within a few minutes depending on the size of your site. You can navigate away — the audit continues in the background and the result will appear in your audit history when complete.

***

## Audit Status

| Status         | Meaning                                      |
| -------------- | -------------------------------------------- |
| **Pending**    | Audit queued and waiting to start            |
| **Processing** | Crawl in progress                            |
| **Completed**  | Results are ready to view                    |
| **Failed**     | Crawl encountered an error — retry the audit |

***

## Audit History

All past and in-progress audits appear in the audit list, sortable and filterable:

* **Filter by Digital Experience** — Show audits for a specific website only
* **Sort by** — Created Date or Overall Score (ascending or descending)

**Each row in the list shows:**

| Column            | Description                                 |
| ----------------- | ------------------------------------------- |
| **Site**          | The Digital Experience that was audited     |
| **Overall Score** | 0–100 health score with color-coded circle  |
| **Status**        | Current audit state                         |
| **Progress**      | Completion percentage bar                   |
| **Issues**        | Count of Critical, Warning, and Info issues |
| **Created Date**  | When the audit was started                  |

Click **View Details** on any completed audit to open the full report.

***

## Reading an Audit Report

### Overall Score

A circular score indicator at the top of the report shows your site's SEO health at a glance:

| Score      | Health                                           |
| ---------- | ------------------------------------------------ |
| **80–100** | Good — site is well-optimized                    |
| **60–79**  | Fair — notable issues to address                 |
| **0–59**   | Needs improvement — significant problems present |

### Issue Summary

Three cards beneath the score show a count of issues by severity:

| Severity     | Color  | Priority                                     |
| ------------ | ------ | -------------------------------------------- |
| **Critical** | Red    | Fix immediately — actively hurting rankings  |
| **Warning**  | Yellow | Fix soon — missed optimization opportunities |
| **Info**     | Blue   | Fix when possible — minor improvements       |

### Issue List

Every discovered issue appears in an expandable accordion. Click any issue to see:

* **Title** — What the issue is (e.g. "Missing meta descriptions")
* **Description** — A detailed explanation of why it matters
* **Affected pages** — How many pages are impacted
* **Recommendation** — A specific, actionable step to resolve it

<Tip>
  Start with Critical issues — they have the highest impact on rankings and are typically the quickest to fix (missing tags, broken links, redirect chains).
</Tip>

***

## Common Issues Found in Audits

<AccordionGroup>
  <Accordion title="Missing meta descriptions">
    Pages without a meta description miss the opportunity to control how they appear in search results. Add a unique, keyword-rich meta description (150–160 characters) to every indexed page.
  </Accordion>

  <Accordion title="Missing or duplicate title tags">
    Title tags are one of the strongest on-page SEO signals. Each page should have a unique title (50–60 characters) that includes the primary keyword for that page.
  </Accordion>

  <Accordion title="Slow page load times">
    Pages that load slowly are penalized in Core Web Vitals scoring. Common causes include unoptimized images, render-blocking scripts, and large JavaScript bundles.
  </Accordion>

  <Accordion title="Broken internal links">
    Links pointing to 404 pages waste crawl budget and create a poor user experience. Audit results list each broken URL and the pages that link to it.
  </Accordion>

  <Accordion title="Missing alt text on images">
    Images without alt text are invisible to search engines and inaccessible to screen readers. Add descriptive alt text to every content image.
  </Accordion>

  <Accordion title="Non-canonical duplicate content">
    Multiple URLs serving the same or similar content can split ranking signals. Use canonical tags to designate the preferred version of each page.
  </Accordion>
</AccordionGroup>

***

## Tracking Improvement Over Time

Run audits periodically — after deploying fixes, launching new pages, or making significant site changes — to track your score over time. The audit history list lets you compare scores across runs to confirm improvements are working.

<Note>
  GTM Suite does not currently auto-schedule recurring audits. Run a new audit manually from the **SEO → Audits** page after making changes.
</Note>

***

## From Audit to Action

Audit recommendations surface directly on the **SEO Overview** dashboard as **Top Recommendations** — the highest-impact Critical and Warning issues from your latest audit, with a **Fix Issue** link to the full detail.

This keeps your most pressing SEO tasks visible without having to dig into the full audit report each time.

***

## Troubleshooting

**Audit stuck on "Processing" for more than 10 minutes**

* Refresh the page — the status updates automatically when the crawl finishes
* If still stuck, the crawl may have timed out on a large site. Try running the audit again.

**Score is lower than expected**

* Check the Critical issues first — even one or two serious technical problems can significantly drag down the overall score
* Ensure the tracker is installed on the site so GTM Suite has the most accurate picture of your pages

**Some pages are missing from the audit results**

* Pages behind login, session cookies, or IP restrictions cannot be crawled
* Confirm the pages are publicly accessible by opening them in a private/incognito browser window

**Audit failed with an error**

* Verify the Digital Experience URL is correct and the site is live
* Check that the domain is not blocking automated crawlers via `robots.txt`

<CardGroup cols={2}>
  <Card icon="search" href="/seo-discoverability" title="SEO & Discoverability">
    Overview of all SEO tools in GTM Suite.
  </Card>

  <Card icon="sparkles" href="/copy-optimizer" title="Copy Optimizer">
    Fix content issues surfaced in your audit with AI-powered rewrites.
  </Card>
</CardGroup>
