Error Establishing a Database Connection WordPress Fix

Check wp-config.php Credentials

The most common cause for a wordpress can't connect to database error is incorrect database credentials in your wp-config.php file. Access your site via FTP or your hosting control panel's file manager. Locate wp-config.php in your WordPress root directory. Look for lines defining DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST. Verify these match the credentials provided by your hosting provider. Even a single typo will cause a wordpress database connection failed completely error. If you recently migrated, check our guide on WordPress Database Connection Error After Migration or Host Change.

define('DB_NAME', 'your_database_name');
define('DB_USER', 'your_database_username');
define('DB_PASSWORD', 'your_database_password');
define('DB_HOST', 'localhost');

Verify Database Server Status

Sometimes, the issue isn't with your WordPress configuration but with the database server itself. Your hosting provider might be experiencing downtime or maintenance. Log into your hosting control panel (cPanel, Plesk, etc.) and look for a "Databases" or "MySQL Databases" section. Try to access phpMyAdmin or create a new database. If you can't, or if it's slow, your database server might be offline. Contact your host immediately to confirm its status.

Repair Your WordPress Database

A corrupted database can also lead to an "Error Establishing a Database Connection." WordPress has a built-in repair tool. To enable it, add the following line to your wp-config.php file, just before the /* That's all, stop editing! Happy publishing. */ line. Warning: Always back up your database before attempting repairs. Incorrect repairs can lead to data loss. After adding the line, visit http://yourdomain.com/wp-admin/maint/repair.php in your browser. Once repaired, remove the line from wp-config.php.

define('WP_ALLOW_REPAIR', true);

Check for Plugin/Theme Conflicts

Although less common for a full "Error Establishing a Database Connection," a faulty plugin or theme could, in rare cases, trigger this if it's heavily interacting with the database on load and failing. If you can access your site via FTP, try renaming your wp-content/plugins folder to wp-content/plugins_old. This deactivates all plugins. If the site comes back, reactivate plugins one by one to find the culprit. Do the same for your active theme in wp-content/themes if plugins don't resolve it.

If none of these steps resolved it, this is where professional help saves time.

If you've followed these steps and your WordPress site still displays the "Error Establishing a Database Connection," the problem is likely more complex. At this point, attempting further DIY fixes without expert knowledge risks further damage or significant downtime. Our team specializes in quickly diagnosing and resolving these persistent issues, getting your site back online efficiently.