🧭 Overview
If a generated report contains unexpected data, missing metrics, or results that don't match your expectations, this guide will help you identify the root cause and take corrective action. Working through these steps systematically will resolve the majority of report quality issues.
🗂️ How to Access Your Reports
Navigate to Left sidebar → Reports or go directly to /report-builder/projects-list. From here you can open, edit, regenerate, or review any existing report.
⚠️ Common Causes of Report Quality Issues
- Incorrect date range selected: The report pulled data from the wrong time period, causing metrics to appear off or incomplete.
- Wrong project or domain configured: The report is pulling data for a different property than intended.
- Filters applied unintentionally: Active keyword, location, or device filters may be excluding data you expect to see.
- Data source not yet indexed: New projects or recently added keywords may not have enough historical data to populate all metrics.
- Cached or stale data: The report may have been generated before the latest crawl or ranking update completed.
- Metric misalignment: The report template includes metrics that don't apply to the selected project type or subscription tier.
- Template misconfiguration: Sections, widgets, or branding elements were not set up correctly before generation.
🔎 Step-by-Step Diagnosis
- Open the report in question. Go to Left sidebar → Reports, locate the report, and open it for review.
- Check the date range. Confirm the date range shown in the report matches the period you intended to cover. Adjust and regenerate if needed.
- Verify the linked project and domain. Inside the report settings, confirm the correct project and domain are selected. A mismatch here is one of the most common causes of inaccurate data.
- Review active filters. Check for any keyword, location, device, or tag filters that may be narrowing the data. Remove unintended filters and regenerate the report.
- Compare data against the live dashboard. Open the corresponding project dashboard and compare key metrics directly against what appears in the report. If the dashboard matches your expectations but the report does not, the issue is in the report configuration, not the underlying data.
- Check when the report was last generated. If the report was generated before a recent crawl or ranking refresh completed, regenerate it to pull the latest data.
- Inspect the template settings. Open the template used for this report and confirm all sections and widgets are correctly configured for the project type. Remove or replace any widgets that are not applicable.
- Regenerate the report. After correcting any configuration issues, regenerate the report and review the output before sending it to your client.
✅ Data Validation Checklist
Before sending any report to a client, run through the following checks:
- Date range is correct and clearly labeled.
- Domain and project name match the client's property.
- All key metrics are populated and not showing as zero or blank.
- No unintended filters are active.
- Branding, logo, and client name are accurate.
- Metrics align with the client's goals and the report template purpose.
- The report was generated after the most recent data refresh.
🛠️ When to Regenerate vs. Reconfigure
Regenerate the report when the configuration looks correct but the data appears stale or incomplete. This forces the system to pull the most current data available.
Reconfigure the report when the date range, project, domain, filters, or template settings are incorrect. Always regenerate after making configuration changes.
📋 Information to Gather Before Contacting Support
If the steps above do not resolve the issue, collecting the following information in advance will allow our team to investigate efficiently without needing to follow up multiple times:
- The name and URL of the affected report.
- The project and domain the report is linked to.
- The date range the report was configured to cover.
- A description of what the report shows versus what you expected to see.
- Screenshots or a screen recording highlighting the specific discrepancy.
- Whether the live dashboard for the same project shows correct data.
- The date and time the report was originally generated.
💬 Contact Support
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.