General Troubleshooting#

Diagnostic sequence#

1. Create a backup or use staging.
2. Record the error, URL, time, and reproduction steps.
3. Check WordPress, PHP, and product versions.
4. Clear page cache, object cache, browser, and CDN.
5. Resave Settings > Permalinks for URL/404 issues.
6. Check Site Health and PHP error logs.
7. Test plugin conflicts one by one on staging.
8. Test with default product configuration.

ZIP installation failed#

Ensure the theme is installed via the Themes menu and the plugin via the Plugins menu. Use the original ZIP file; structure errors are often caused by double wrapper folders.

License or update failed#

Check HTTPS, domain, expiry, activation limits, server time, outbound connections, firewall, and DNS. Clear the update cache, then run Check Update.

Broken layout#

Temporarily disable cache/minify on staging, check custom CSS/JS, regenerate thumbnails, and ensure child theme compatibility.