Troubleshoot reports and exports

An empty or unavailable report often reflects role, plan, feature, filter, semester, or missing source records. Do not alter teaching history to make a report look populated.

1. Verify the active school.
2. Check the report’s permitted role.
3. Confirm the semester, date range, halqa, learner, recitation type, and status filters.
4. Remove filters one at a time.
5. Verify that source sessions, attendance, or recitations were actually recorded.
6. Distinguish “no matching records” from a loading or server error.

• School-administration reports can be admin-only.
• A sheikh may see only assigned learners or specific planning reports.
• A parent gets linked-child read views, not administrative exports.
• PDF availability differs from CSV/XLSX availability.
• CSV/XLSX and planning exports require their effective plan or feature.

Review report and export availability before changing a subscription or role.

1. Submit the export once and allow it to finish.
2. Check browser download permission and available storage.
3. Keep the original extension.
4. For CSV, import as UTF-8 and choose a comma delimiter.
5. Open XLSX in a compatible spreadsheet application.
6. Do not repeatedly request a rate-limited PDF or export.

Return to the source record and filter. For planning output, verify the plan, assignment, Quran range, dataset capability, effective workload, tolerance, and selected boundary. Structural pages and 15-line equivalents are separate measures. Forecasts are projections, not guarantees.

Provide the report name, school, role, filters, approximate time, format, and visible error. Use a sanitized screenshot when needed. Do not send an unredacted export or unrelated learner data.

See reports overview and planning calculations.