Troubleshooting Guide

Diagnose and fix the most common Reports, Charts, Templates, CQL & Export for Confluence issues quickly.

Quick Reference

Empty Report Results

Problem: My report is empty - no results appear.

Check in this order:

1. Viewer permissions - does the viewer have access to the selected spaces/pages?
2. CQL correctness - try a broader query like type=page to confirm CQL is working.
3. Filters - remove filters one by one to see if a filter is excluding all results.
4. Expansions - confirm required expansions for columns/filters are loaded.

Blank Column Values

Problem: A column shows empty/blank values.

Check in this order:

1. Required expansion loaded - confirm the expansion group for that field is checked in the left panel.
2. JSON path correct - open Raw View and verify the exact path to the field.
3. Field exists for content type - some fields only exist for pages, not blogs or attachments.

Chart Display Issues

Problem: Charts don't show expected results.

1. Check Group By field - it must be a suitable field for aggregation.
2. Check dataset size - chart may be empty if dataset is too small or over-filtered.
3. Check filters and date windows - ensure they're not excluding too much data.

Performance Issues

Problem: Report feels slow to load or update.

1. Reduce expansions - load only the expansion groups you actually need.
2. Lower result limit - start with 50 records, increase only when needed.
3. Narrow scope - use a more specific CQL query or fewer spaces before adding heavy expansions.

Debug Workflow