Report generation failures: common errors and fixes
What to do when a clariBI report does not generate, comes out empty or cannot be scheduled, shared or downloaded: credits, data sources, missing fields, plan limits and permissions.
Before you start
Open Reports and check the report's status in the Reports tab: Generating, Completed or Failed. Generation runs in the background, so a report can show Generating for a while; you get a notification when it is done. The normal flow is described in generating a report.
Not enough AI credits
What you see: "Insufficient credits", "AI credits limit exceeded", or a message that credits are exhausted.
Fix:
- Check the balance in the sidebar under Usage This Month or in Settings > Billing. AI credits explains how they are counted.
- Wait for the monthly reset, buy a credit pack under Add-ons & Overages, or upgrade.
- Select fewer data sources; reports that read less data use fewer credits.
"AI analysis requires a paid subscription"
The organization is on Free or Lite, which do not include AI reports. Choose Starter or above in Settings > Billing; the pricing page shows what each plan includes.
"At least one data source with data is required" / "No data sources found for this report. Please connect a data source first."
The selected sources have no data yet, or none were selected.
- Open Settings > Integrations and check that the source shows as connected and has rows (open it to see the data overview). If it shows an error, see data source errors.
- If it was just connected, wait for the first sync to finish.
- Generate the report again with that source selected.
Data Mismatch Detected
What you see: the report shows Data Mismatch Detected: The connected data source does not contain the fields required for this analysis, with the fields it did find.
Fix: pick a template that matches your data, or connect a source that has the missing fields. Any credits refunded for the run are shown on the report.
A section says there is no data
A metric with no matching rows is shown as empty with a plain statement rather than invented numbers. Check the period the data covers (the Data Scope in the introduction) and whether the source contains that metric.
The data looks old
Before generating, clariBI syncs sources whose data is older than their sync interval (usually 24 hours). Data a few hours old is not fetched again. Click Sync Data on the source first if you need the latest numbers, then generate.
The report stays in Generating
Large sources and templates with many metrics take longer. If it is still generating after 15 minutes, check Jobs (the progress indicator in the header links to it). If the job failed, generate the report again. If it fails twice, contact support with the report name and time.
Scheduling errors
| Message | Fix |
|---|---|
| "Report Scheduling requires Professional plan or higher" | Upgrade, or generate the report by hand |
| "Can only schedule completed reports" | Wait until the report has finished, then schedule it |
| "Only the report creator can schedule regeneration" | Ask the person who created the report to schedule it |
| "At least one recipient email is required" | Add at least one email address under notifications |
A scheduled run that fails usually means credits ran out or a source was deleted or lost its sign-in. Fix that; the next run happens on schedule. See Scheduling reports.
Sharing and download errors
| Message | Fix |
|---|---|
| "Only the report creator can generate public sharing links" | Ask the report's creator to turn on the public link |
| Public link switch is locked | Public links need Professional or Enterprise |
| "Report is not completed yet" | Wait for generation to finish before downloading |
| "Failed to download report" | Reload the page and try again; if it persists, contact support |
| "Select up to 10 reports per download." | Download the selected reports in batches of 10 or fewer |
| "Downloading several reports at once is included in the Professional and Enterprise plans." | Download reports one at a time, or upgrade; see export formats |
Contacting support
Send support@claribi.com the report name, the template, the data sources, the time of the attempt and a screenshot of the message.