> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshooting and FAQs

# Troubleshooting and FAQ

## Why does the Dashboard show No data?

AgentWatch uses completed-day aggregate reporting. **No data** can be valid when
the store has no AI-referred activity, Shopify has not made the report
available, or the first analytics sync has not run.

Try these steps:

1. Open Settings and run **Sync 30 completed days**.
2. Open Health and run **Run health checks**.
3. Review **Shopify analytics access** and **Global Catalog analytics**.
4. Check the latest sync timestamp on the Dashboard.

No data is not converted into zero and is not treated as an outage.

## Why is the live analytics card unavailable?

The live card requires embedded Shopify analytics access, the required report
permission, and Shopify approval for the relevant protected data access.

Run Health and inspect **Shopify analytics access**. If it remains blocked,
contact AgentWatch Support because the app provider might need to complete a
Shopify access or deployment requirement.

## Why is the Products page empty?

The store might have no product-level Global Catalog search requests for the
selected period. This does not prove that products were removed from Global
Catalog.

Run an analytics sync, try a longer range, check the Health page, and verify the
product's Active and publication state in Shopify Admin.

## Why do I only see 7 days and 5 products?

Your store is on the Free plan. AgentWatch still collects the full history, so
after you upgrade to Monitor or Optimize, the 30 and 90-day views and up to 20
products appear immediately. Select **Compare plans** on the notice to upgrade.

## Why is the Opportunities page empty?

Check these in order:

1. Your store is on the Optimize plan. Other plans show an upgrade notice.
2. Analytics have been synced. Opportunities use the last 30 completed days.
3. At least one product has 20 or more AI searches in that period. Quieter
   products never appear.
4. A product with enough demand also shows a signal. A popular product that
   sells well, has complete data, and steady demand has nothing to flag, which
   is good news.

## Why does a product show Not audited yet?

The readiness audit has not checked it yet. Select **Run first audit** or **Run
readiness audit** on the Opportunities page, or wait for the daily audit. Draft, archived, and gift
card products are never audited.

## Why do AI-referred orders show Unavailable?

AgentWatch could not confirm product sales for every day in the period, for
example right after you upgrade or when Shopify analytics were briefly
unavailable. Unavailable means unknown, not zero. Run **Sync 30 completed
days** in Settings, then check again.

## Why does a product edit not appear in Did your edits help?

AgentWatch records an edit only when:

- The store is on the Optimize plan when the edit is made.
- The product is active.
- The edit changes the title, description, product type, vendor, option names,
  images or their alt text, or a variant's price, SKU, or barcode. Stock-only
  changes are ignored.
- AgentWatch already knew how the product looked before. Run the readiness
  audit once after upgrading so your next edits can be tracked.

## Why does a product edit still say Measuring?

Results need 14 completed days after the day of the edit. The result shows how
many days are left.

## Why does Product visibility show Unknown?

AgentWatch needs an active merchant-owned product for a safe read-only lookup.
If none is available, it reports Unknown rather than incorrectly reporting a
failure.

## Why did a health warning not create an incident?

A single health failure does not open an incident. The same eligible check must
fail twice consecutively for Warning and three times for Critical. Some setup
conditions, such as blocked analytics access or no active product, are not
eligible for automatic incidents.

## Why did a large percentage drop not create an incident?

Traffic and catalog incidents require eight consecutive completed days and a
minimum seven-day median baseline. The minimum is 20 sessions for a channel and
100 requests for Global Catalog. Missing history and low-volume signals are not
treated as outages.

## Why did I not receive an email alert?

Check that:

- Your store is on the Monitor or Optimize plan. The Free plan does not send
  incident emails.
- The alert email is correct.
- **Enable email alerts** is selected.
- The relevant alert category is selected.
- The incident opened, escalated to Critical, or recovered automatically.
- The message is not in a spam or filtering folder.

Manual resolution and routine monitoring runs do not send alerts. Open the
incident and check **Alert delivery** for its recorded status.

## What does a Partial job mean?

One or more upstream reads failed while another source succeeded. AgentWatch
retains previously good data instead of replacing it with an incomplete result.
Wait and rerun the operation. If it repeats, contact support with the job time
and a diagnostic packet from any related incident.

## Why do I need to wait before running an operation again?

Manual sync, health, and incident-evaluation operations have a one-minute
cooldown. This prevents accidental duplicate work and avoids unnecessary
requests to Shopify.

## Why does the plan show $0 and Free to test?

You are using an eligible Shopify development store. Shopify creates a
no-charge test subscription while preserving the regular price for production
stores.

## Does AgentWatch fix an incident automatically?

No. AgentWatch observes signals, records evidence, and reports recovery. It
does not change products, themes, store configuration, or external AI services.

## What should I include in a support request?

Include:

- The Shopify store domain.
- The approximate time the issue occurred.
- The affected AgentWatch page.
- The latest sync or health-run timestamp.
- The copied diagnostic packet when an incident exists.

Do not include passwords, Shopify access tokens, API keys, payment information,
or customer data. Use the support address in the AgentWatch App Store listing.

Next: [Glossary](11-glossary.md)