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

# Troubleshooting

> Start here when something looks wrong. Each page below is indexed by the symptom on screen — pick the one that matches, then follow the cross-links to the underlying fix.

Every other section in the docs is organized by feature — filters, custom metrics, connectors — which is fine when the failing feature is known. Troubleshooting works the other way: pages are indexed by the symptom the customer sees, and each page routes to the feature or connector FAQ that explains the specific cause.

## Try this first

A hard refresh from the dashboard header resolves a surprising share of issues. It re-runs every widget against the latest source data — bypassing both the browser cache and the server-side query cache.

<Steps>
  <Step title="Click Refresh data in the dashboard header">
    A browser page refresh does not do this — it just re-renders the cached data.
  </Step>

  <Step title="Check the data source list">
    Open the **Data sources** tab in the left sidebar. A warning icon next to a source means the connection is broken — reconnect before troubleshooting anything else.
  </Step>

  <Step title="Widen the date range">
    Attribution windows on most ad platforms shift conversions for days or weeks after the click. Recent dates can legitimately look empty.
  </Step>
</Steps>

## Pick the symptom that matches

<CardGroup cols={2}>
  <Card title="Data not loading" href="/troubleshooting/data-not-loading">
    A widget shows "No data" or a warning icon. The data source is disconnected, the widget points at the wrong source, or a filter is excluding every row.
  </Card>

  <Card title="Delayed or missing data" href="/troubleshooting/delayed-or-missing-data">
    Data exists on the platform but hasn't reached the dashboard yet, or the requested date range pre-dates what Adriel has cached.
  </Card>

  <Card title="Numbers don't match the source platform" href="/troubleshooting/numbers-dont-match-source-platform">
    The dashboard shows a different total than the ad platform's UI for what looks like the same metric and date range.
  </Card>

  <Card title="Data differs between widgets" href="/troubleshooting/data-differs-between-widgets">
    Two widgets on the same dashboard show different numbers for the same metric.
  </Card>

  <Card title="Widget is empty or missing rows" href="/troubleshooting/widget-empty-or-missing-rows">
    The widget query ran, but the result is empty or shows fewer rows than expected.
  </Card>

  <Card title="Revenue: GA4 vs Google Ads" href="/troubleshooting/revenue-ga4-vs-google-ads">
    The two revenue figures don't line up, even for the same store on the same day.
  </Card>

  <Card title="Ad accounts disconnected overnight" href="/troubleshooting/ad-accounts-disconnected-overnight">
    Everything was working yesterday. Today most data sources on the platform show a disconnect warning.
  </Card>

  <Card title="Invited but no data" href="/troubleshooting/invited-but-no-data">
    Signed in after an invitation, but the shared workspace or its dashboards don't appear.
  </Card>

  <Card title="Recover a deleted teamspace" href="/troubleshooting/recover-deleted-teamspace">
    A teamspace, folder, or dashboard is gone. Confirm who deleted it and what can be restored.
  </Card>

  <Card title="Shared link error" href="/troubleshooting/shared-link-error">
    A share link opens to an error page, or a viewer can't change dates on an interactive share.
  </Card>
</CardGroup>

## When the issue is connector-specific

For platform-specific errors (a Meta token that expired, a Google Ads Purchase metric that reads differently in the platform UI, a TikTok metric that returns null), the per-connector **FAQs** page is the fastest path. Every folder under **Data sources A-F**, **G-N**, and **O-Z** has one.

## Still stuck?

<Card title="Contact support" icon="life-ring" href="mailto:support@adriel.com">
  Email `support@adriel.com` or use the in-app chat. Include the affected dashboard URL, a screenshot of the issue, the data source name, and the exact time the problem occurred. Faster turnaround comes from a clear repro.
</Card>