FAQ
Q: Do viewers see the same results as the author?
No. Reports respect Confluence permissions. Users only see content they are allowed to access. Two users viewing the same report may see different results.
Report Reusability
Q: Can I reuse a report across spaces?
Yes. Use Templates or Export/Import JSON recipes. Best practice: store recipes on a shared Confluence page (e.g., a Report Library page).
Data Source Selection
Q: When should I prefer CQL over Spaces drill-down?
| Scenario | Use This |
|---|---|
| Simple, browse-based selection, non-technical users | Spaces (Drill-down) |
| Rules-based, dynamic queries, complex conditions | Custom CQL |
| Content from known specific pages or spaces | Spaces (Drill-down) |
| Content that updates automatically as Confluence changes | Custom CQL |
Debugging & Troubleshooting
Q: What's the safest way to debug field issues?
- Open Raw View to confirm JSON paths.
- Ensure required expansions are loaded.
- Check field compatibility and availability using Explore.
Images & Visual Columns
Q: How do I add profile pictures to reports?
- Add a new column in the Columns tab.
- Select Image as the block type.
- Load the history or metadata expansion.
- Pick the profile picture field from the expansion.
- Adjust the size slider - the size is shown in pixels.
Q: Can I control image size?
Yes. Use the size slider in the Image block configuration - the pixel dimensions are shown in the UI.
Field Compatibility
Q: What does '(X compatible)' mean next to a column block type?
It shows how many available fields can work with the selected block type. Higher number means more usable fields are available for that block.
Columns
Q: What is the difference between Duplicate and Hide column actions?
| Action | What It Does | When to Use |
|---|---|---|
| Duplicate | Creates a copy of the column with identical configuration | When you need a similar column with minor changes |
| Hide | Removes the column from display but keeps the configuration | When you want to temporarily exclude a column without losing its setup |
Quick Troubleshooting Reference
| Symptom | Check |
|---|---|
| Empty report | Permissions + CQL correctness + Filters + Expansions |
| Blank column values | Expansions loaded + Raw View path + Field availability |
| Slow performance | Reduce expansions + Lower result limit + Narrow scope |
| Chart not showing | Field type for Group By + Dataset size + Filters |