# AI Visibility Reports Dashboard

The AI Visibility Reports dashboard shows all reports run for your property. Each report tests how AI assistants recommend your brand across multiple platforms and discovery queries.

## What You'll Learn

In this guide, you'll learn:

- How to understand report statuses and scores
- How to view, download, and manage reports
- How location settings affect your reports
- What to do if your site can't be crawled

## Reports Table

The main table displays all reports for your property with:

| Column | Description |
|--------|-------------|
| **Consistency Score** | How accurately your brand appears in AI responses (0-100) |
| **Date Run** | When the report was generated |
| **Status** | Current state of the report (completed, processing, failed) |
| **Actions** | View, download PDF, download PowerPoint, delete |

### Understanding Consistency Score

The consistency score measures how accurately your brand is represented by AI platforms. A higher score means AI assistants understand your business, product, or service, and can describe it correctly when users ash about it.

Scores typically range from:
- **70-100**: Strong AI accuracy - only minor differences in how AI describes features, differentiators, etc.
- **50-69**: Some consistency - core description may be correct but key components like target customer or key features are not correct.
- **0-50**: Unknown or incorrect - Your brand is not included in AI models or is confused with a different brand

### Report Statuses

- **Completed**: Report finished successfully and is ready to view
- **Processing**: Report is currently running (can take 5-15 minutes)
- **Failed**: Report encountered an error - check site accessibility

## Location Settings

If a location is set for your property in [/docs/dashboards/settings](Settings), it will appear on this page. Location affects which discovery queries are generated and how AI platforms interpret searches.

**Local businesses should always set a location** to get the most relevant results. Without location context, AI platforms may recommend businesses anywhere in the world rather than locally relevant options.

To set or update your location:
1. Go to Settings from the property sidebar
2. Navigate to the Reports tab
3. Enter your city, region/state, and country
4. Save changes

Future reports will use this location for location-aware queries like "best [service] near [location]."

## Brand Snapshot

When you run a report, Spyglasses first creates a brand snapshot by analyzing your website. We select the home page plus several other high-value pages to build a structured understanding of your brand, including:

- Company name and description
- Product category
- Target audience and customer segments
- Key features and problems solved
- Pricing model

This snapshot informs how we generate discovery queries and identify relevant competitors.

## Viewing Reports

Click **View** to open the full report, which includes:
- Summary metrics (consistency, share of voice, mentions, citations)
- Performance by AI platform (ChatGPT, Gemini, Claude, and more)
- Discovery query breakdown
- Competitor analysis
- Grounding search rankings — the fan-out searches each assistant ran, checked in the engine it grounds in (Google for ChatGPT and Gemini, Brave for Claude)
- Citation sources

## Downloading Reports

Reports can be downloaded in two formats:

- **PDF**: Best for sharing via email or archiving
- **PowerPoint**: Best for presentations and stakeholder reports

Downloads include all charts, metrics, and analysis from the online report. Spyglasses customers on an [/pricing](Agency plan) can white-label these reports.

## Deleting Reports

Click the delete icon to remove a report. **Deletion is permanent and cannot be undone.** Historical metrics derived from deleted reports will also be removed.

Only delete reports if:
- A report failed or has incorrect data
- You're cleaning up test reports
- You need to remove outdated historical data

## Site Accessibility Issues

If Spyglasses cannot crawl your site to generate a brand snapshot, reports will fail. Common causes include:

- **Robots.txt blocking**: Your robots.txt may be blocking our crawler
- **Cloudflare or security rules**: Bot protection may be preventing access
- **Site requires JavaScript to render**: Our crawler mimics AI assistants, which don't browse with JavaScript enabled. If our crawler can't see your site, neither can AI!

For detailed troubleshooting, see [Is Your Site Visible to AI Assistants?](/docs/help/is-your-site-visible-to-ai-assistants)

## Running New Reports

To run a new report:
1. Click the "Run Report" button
2. Wait for the report to complete (4-5 minutes)
3. View results when status changes to "Completed"

### Report Billing

AI Visibility Reports are billed as follows for **active** subscribers on **Brand**, **Agency**, and **Enterprise** plans:

- **Your first report for a property is free.** Spin up a new property for a client or prospect and run the initial visibility report at no cost — ideal for bootstrapping AI visibility tracking.
- **Free refresh every 3 months.** Any AI Visibility Report run more than 3 months after the most recent one for a property is also free.
- **Within the refresh window?** Running another report before the 3-month window has elapsed will consume credits. Check Settings > Billing to see your credit balance, or wait until your next free refresh is available.

> **Note:** These free-tier rules apply only to active paying subscriptions. **Promotional trials always consume credits** — we include trial credits so you can evaluate the product.

**Pay As You Go** customers pay credits for every report — there's no free tier. If you regularly track AI visibility, subscribe to Brand or Agency to unlock the free-first-report and quarterly refresh benefits.

### Ongoing tracking: use Projects instead

If you want to track AI visibility continuously rather than running one-off reports every few months, create a **Project** under your property. Projects track bundled prompts daily across AI platforms and are included in Brand and Agency plan allocations — no per-report credit charges for the prompts inside your plan's allotment.

## Scheduling Reports

Rather than running reports manually, you can schedule them to run automatically:
1. Go to Settings from the property sidebar
2. Navigate to the Reports tab
3. Select a frequency: Weekly, Monthly, or Quarterly
4. Save changes

Scheduled reports run automatically and appear in this dashboard when complete.

## Related

- [Historical Metrics](/docs/dashboards/historical-metrics) - Track report results over time
- [Discovery Queries](/docs/dashboards/discovery-queries) - Manage queries tested in reports
- [Settings](/docs/dashboards/settings) - Configure location and scheduling
- [Is Your Site Visible to AI Assistants?](/docs/help/is-your-site-visible-to-ai-assistants) - Troubleshoot crawl issues
