Skip to content

Troubleshooting WordPress issues

WordPress is a powerful and modular CMS, but sometimes problems arise due to plugins, themes, or server configurations. On ruachost.com, you can follow these steps to identify and resolve common WordPress issues.

  • Blank pages / White Screen of Death → Often caused by faulty plugins or themes.
  • Database connection errors → “Error establishing a database connection.”
  • Scheduled maintenance message → “Briefly unavailable for scheduled maintenance.”
  • Performance issues → WordPress heartbeat or cron jobs consuming resources.
  • Plugin/theme conflicts → Incompatibility after updates.
  • Go to Plugins → Installed Plugins.
  • Deactivate all plugins, then reactivate them one by one.
  • Switch temporarily to a default theme (e.g., Twenty Twenty‑Five).
  • Identify which component causes the issue.
  • Edit your wp-config.php file.

  • Add or update the following line:

    define('WP_DEBUG', true);
  • Errors and warnings will now display, helping you pinpoint the problem.

  • Verify database credentials in wp-config.php.
  • Ensure MySQL server is running.
  • Repair database tables via phpMyAdmin or command line.
  • If stuck in maintenance mode, delete the .maintenance file in your WordPress root directory.
  • Disable or adjust the WordPress heartbeat API.
  • Replace the default cron job with a server‑side cron for better efficiency.
  • Use caching plugins (e.g., WP Rocket, W3 Total Cache).
  • Ensure PHP version and memory limits meet WordPress requirements.
  • Update to the latest WordPress version.
  • Review error logs in cPanel/Plesk for server‑side issues.
  • Always back up your site before troubleshooting.
  • Test changes in a staging environment before applying them live.
  • If issues persist, contact ruachost.com Support for assistance.