DiagnosticsImproved in 5.17+
Freeform's Diagnostics page helps you identify configuration issues, check your installation, and share useful information with Solspace Support. Open Freeform → Settings → Diagnostics in the Craft control panel.
Visit this page when setting up Freeform, after updating your site, or when troubleshooting a problem. It includes an Overview of your installation and a Health Checks tab for running more detailed checks.
Overview
The Overview tab summarizes your server, Craft configuration, and Freeform settings:
- Server Checks: Freeform edition and version, available Freeform updates, Craft and PHP compatibility, database driver and version, operating system, memory and execution limits, upload limits, PHP sessions, extensions, and ModSecurity.
- Site Settings: Environment, Dev Mode, admin changes, multi-site configuration, async CSRF inputs, automatic queue processing, Craft upload limits, email configuration, and detected Blitz caching.
- General Settings: Submit-button behavior, automatic scrolling, duplicate-submission prevention, CSRF refresh, JavaScript insertion, session context, search indexing, queue usage, data purging, and site-aware forms.
- Spam Controls: Spam storage and behavior, blocking options, minimum submission time, form expiration, submission throttling, and bypass settings.
- Templates: Formatting, email, and success template directories and storage settings.
- Notices & Alerts: Developer Digest, critical error reports, update notices, logging level, and log entry counts with links to relevant logs.
- Statistics: Counts of forms, fields, favorite fields, submissions, spam submissions, templates, integrations, and form types.
- Integrations, Form Types, and Modules: A summary of integration usage, form types, and installed Craft modules.
A banner highlights potential issues or advisories. Status indicators help you interpret individual settings:
- 🟢 Green - Enabled / Valid
- ⚪️ Gray - Disabled
- 🟡 Yellow - Advisory
- 🔴 Red - Potential issue
A disabled setting is not necessarily a problem. Review the accompanying explanation to decide whether a change is needed.
Health ChecksNew in 5.17+
The Health Checks tab provides seven checks for database structure, saved data, and configuration. Click Run Check beside a check to start it. You can also click its heading to expand or collapse its details.
Checks run only when requested and do not change your data. Progress and totals appear while scans run; large sites may take longer to finish.
All checks are read-only. Notification and integration checks review saved settings without rendering Twig, sending emails, or contacting external services.
- Database Integrity - Checks expected tables, columns, indexes, and foreign keys. See the console checks and foreign-key repair instructions. Structural issues beyond foreign keys require developer review.
- Orphaned Submissions - Finds submissions whose Craft element or Freeform form no longer exists. Ask your developer to preview cleanup if orphans are found.
- Related Data Integrity - Finds related records with missing parents or duplicate data. The cleanup command handles orphans. Duplicates require separate developer review.
- Uploaded File Integrity - Checks upload references, including Table fields, for missing assets or files. Unreadable values and unavailable storage are reported separately.
- Notification Readiness - Checks enabled notifications on active forms for missing templates, recipient fields, rule references, and invalid email settings. It does not verify delivery.
- Integration Readiness - Checks enabled integrations and active form connections for missing settings, credential and OAuth configuration issues, and broken field references.
- Queue Health - Flags failed jobs, overdue jobs, and jobs waiting to run for at least an hour, including jobs from other plugins. Scheduled delays are respected. Custom queue drivers may require developer review.
Understanding Results
| Status | Meaning |
|---|---|
| Not checked | Not run in this page session. |
| Running | The check is in progress. |
| Passed | No issues or unchecked items were found. |
| Needs attention | Issues were found, or some items could not be checked. |
| Information | Informational findings, such as upload values that could not be inspected. |
| Incomplete | The check did not finish. Results may be partial. |
Findings appear under Issues, Unchecked, or Information. Some checks show only the first 100 findings, but totals include all results.
Use the available action links to review affected items, make corrections, and run the check again. Links depend on your permissions.
Form DiagnosticsNew in 5.17.3+
For diagnostics about a specific form, open its builder and go to Settings → Usage & Stats. This page shows submission activity, form configuration, and troubleshooting details. Click Copy diagnostics to copy a support report, or share a screenshot.
See the Usage & Stats documentation for more information.
Sharing Results with Support
Click Copy Support Report to copy the installation-wide Overview report. You can also expand Support Report to view and manually copy its contents. Run Database Integrity before copying to include its results.
For an issue affecting a specific form, also include its Copy diagnostics report from Settings → Usage & Stats. This reflects the current builder settings, including any unsaved changes.
Send the reports with a description of the problem, steps to reproduce it, and any relevant health-check messages or screenshots.
- Private support ticket - Get help with your site and share diagnostic reports or screenshots privately.
- GitHub Issues - Report reproducible bugs or suggest features publicly, without sharing private site or customer details.