Error establishing database connection WordPress-2026

Error Establishing Database Connection: How to Fix It in WordPress

“Error establishing database connection” is one of the most common issues in WordPress and can occur for various reasons. It usually indicates that WordPress is unable to connect to your website’s database, which brings your entire site down until it’s resolved. Here are the steps to help you troubleshoot and fix this problem.

1. Check Your Login Credentials

Ensure that your database login credentials (username, password, database host, and database name) in the WordPress configuration file (wp-config.php) are correct. You can access this file via FTP or your hosting control panel. Make sure there are no typos or mistakes in the credentials — this is by far the most common cause of an error establishing database connection.

2. Verify Database Server Is Running

Confirm that your database server (usually MySQL or MariaDB) is running correctly. If it’s not, try restarting it from your hosting control panel or contact your hosting provider for assistance.

3. Check Your Database Server Status

Sometimes, the database server may run out of resources or crash entirely. This is another frequent trigger behind an error establishing database connection message. In such cases, you may need to contact your hosting provider to resolve the issue on their end.

4. Check Database Table Prefix

If you have recently migrated your WordPress site, make sure the database table prefix in the wp-config.php file matches the prefix used in the database. It should look like $table_prefix = 'wp_'; by default, but it might be different if you customized it during installation. A mismatched prefix is a sneaky cause of an error establishing database issue after a migration.

5. Review Your Website’s Disk Space

Running out of disk space on your hosting account can also lead to database connection errors. Check your available disk space through your hosting control panel and make sure you have enough room for the database to operate normally.

6. Examine for Plugin or Theme Conflicts

Sometimes, a faulty plugin or theme can cause database connection issues. If you recently installed or updated a plugin or theme before the error occurred, try disabling it. You can do this via FTP by renaming the plugin’s folder (e.g., “pluginname” to “pluginname_disabled”) in the “wp-content/plugins” directory.

7. Test Your Database Connection

Create a simple PHP file (test.php) and add the following code to test the database connection directly:

<?php
$db_host = 'your_database_host';
$db_name = 'your_database_name';
$db_user = 'your_database_username';
$db_password = 'your_database_password';
$conn = mysqli_connect($db_host, $db_user, $db_password, $db_name);
if (!$conn) {
die('Database connection failed: ' . mysqli_connect_error());
}
echo 'Database connection succeeded!';
?>

Replace 'your_database_host', 'your_database_name', 'your_database_username', and 'your_database_password' with your actual database details. Upload the file to your WordPress root directory and access it through your web browser (e.g., www.yourwebsite.com/test.php). If the connection fails, it should give you a more specific error message than WordPress’s generic error establishing database notice, making it much easier to pinpoint the real cause.

8. Contact Your Hosting Provider

If you’ve tried the above steps and the issue persists, it’s best to get in touch with your hosting provider’s support team. They can check server-side logs and assist in diagnosing and resolving the database connection problem faster than you can from the outside.