Troubleshooting

Fresh

Common issues and solutions for MainWP Dashboard and child site management.

Quick Diagnostics

Topics

Guide	Description
Connection Issues	Site won't connect, disconnect errors, timeout problems
Status Codes	HTTP and MainWP-specific error code reference

General Troubleshooting Steps

1. Check MainWP Dashboard → Server Information for warnings
2. Sync the site — many issues resolve after a fresh sync
3. Check child site health — WordPress → Tools → Site Health
4. Review error logs — wp-content/debug.log on both Dashboard and child
5. Verify connectivity — can Dashboard reach child site?

Enable Debug Logging

Add to wp-config.php on the Dashboard:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Check logs at: wp-content/debug.log

Common Quick Fixes

Symptom	Quick Fix
White screen	Increase memory_limit to 512M
Slow Dashboard	Reduce sync frequency, use system cron
"Site not found"	Verify child plugin is activated
Partial sync data	Increase max_execution_time to 300
Extension not working	Deactivate, reactivate, check API key
Blank widgets	Clear browser cache, check JavaScript console