Troubleshooting

Diagnose common issues quickly with symptom-first fixes.

Use this guide to unblock builds, connector flows, and chat operations.

Dashboard build failed

Symptom

Builder shows Build failed or dashboard status remains Failed.

Likely cause

Most commonly malformed input columns, invalid sheet targeting, or prompt constraints that conflict with available fields.

How to fix

1. Re-run with a simpler prompt focused on one business question.
2. Confirm file format and remove unexpected delimiter/header issues.
3. For Excel, verify the selected sheet reference exists.

Dashboard stuck in Queued or Processing

Symptom

Status remains Queued/Processing longer than expected.

Likely cause

The job may be waiting for processing capacity or upstream connector refresh completion.

How to fix

1. Refresh Dashboards list and confirm latest timestamp updates.
2. Check connector status if dashboard came from a connector flow.
3. If delay persists, contact support with dashboard ID and job ID.

Widgets show no data after filtering

Symptom

Charts/tables become empty after filter changes.

Likely cause

Filter combinations can over-constrain the dataset to zero matching rows.

How to fix

1. Reset one filter at a time to isolate the constraint.
2. Start with date range only, then add dimensions gradually.
3. Verify numeric ranges still include valid values.

No credits left for generation

Symptom

Generation is blocked with no credits remaining notice.

Likely cause

Workspace monthly credits are exhausted.

How to fix

1. Go to Account and upgrade plan or buy extra credits.
2. Use existing dashboards while credits are being replenished.

Chat panel connection/auth issues

Symptom

Chat shows connection failed, offline, or request errors.

Likely cause

Session token expiry, transient websocket disruptions, or invalid dashboard context.

How to fix

1. Close and reopen chat panel.
2. Start a New chat session from panel actions.
3. Re-authenticate in the app if token-related errors continue.

Connector access test fails

Symptom

Test access returns error for SQL or Google Sheets connector.

Likely cause

Incorrect credentials, permissions, SSL mismatch, or missing Sheets service-account sharing.

How to fix

1. Verify host/port/database and credentials for SQL connectors.
2. Confirm SSL mode requirements match your database policy.
3. For Google Sheets, share with the exact service-account email shown in setup.

Sharing and invite issues

Symptom

Viewer cannot open shared dashboard or invite remains pending.

Likely cause

Invalid invite email, unaccepted invite, or revoked access.

How to fix

1. Re-send invite with one valid email per line.
2. Confirm recipient accepted invitation from email link.
3. Review and update viewer list in Share dialog.

Related guides

• FAQ — the most common operational questions.
• Connectors & Refresh — schedules, notifications, and access tests.
• Dashboard Workspace — export, sharing, layout, and merge/replace.