How To Fix “Error Establishing A Database Connection” In WordPress

By WP Saviour •  Updated: 02/25/21 •  5 min read

The “error establishing a database connection” message is an particularly irritating WordPress error the place your complete website will get changed by a message that appears like this:


In case you’re studying this submit, there’s likelihood that you simply’re experiencing this error proper now. If not, you’re in luck.

And even for those who’re not watching this message, studying learn how to repair the error establishing a database connection downside continues to be one thing that each WordPress person ought to know.

On this submit, you’ll be taught three issues:

  1. What the “error establishing a database connection” message means
  2. A number of the most typical explanation why this message seems
  3. How you can repair this error in WordPress

In case you’re not acquainted with how WordPress works, there are two important components to a WordPress web site:

Each time a customer lands in your WordPress website, the PHP information in WordPress attain out to your database to find out precisely what info to show.

With out a working connection to the database, the PHP-file a part of your WordPress website can’t get the data it must render a working web page. That’s why it shows the “error establishing a database connection” message as a substitute.

What Causes The “Error Establishing A Database Connection” Message?

There are a number of potential explanation why you’re seeing this message.

More often than not, these causes boil right down to:

As a result of you possibly can’t ensure what’s inflicting the message on your particular state of affairs, one of the best ways to repair the issue is to take a diagnostic strategy.

That’s, you could systematically observe a sequence of checks to isolate (after which repair) the issue.

Right here’s what to do:

How To Repair “Error Establishing A Database Connection” in WordPress

Potential Repair 1: Verify If You Can Nonetheless Entry The WordPress Dashboard

While you see this message on the front-end of your website, the very first thing to do is examine whether or not or not you get the identical error while you attempt to entry your wp-admin dashboard.

In case you nonetheless see the identical precise error message while you attempt to entry your wp-admin space, skip forward to the subsequent step. You’ve already eradicated this downside as a possible trigger.

In case you see a distinct message mentioning one thing like “The database could should be repaired”, proceed with this part to learn to restore your WordPress database.

Step 1: Activate the restore utility within the wp-config.php file.

To get began, you could edit the wp-config.php file on your website. You are able to do this by both:


Your wp-config.php file is situated within the root folder of your WordPress website. That’s the identical folder that incorporates wp-admin and wp-content:


When you’re in a position to edit your wp-config.php file, add this quick code snippet to the underside of the file:

outline( 'WP_ALLOW_REPAIR', true );

Be sure that to avoid wasting your modifications earlier than persevering with.

Step 2: Run the automated database restore utility.
When you’ve added the code snippet, you possibly can entry the WordPress database restore device by going to:

On that web page, click on Restore Database to run the device:


As soon as the device completes its repairs, your website ought to hopefully work once more. If it does, all you could do is return to your wp-config.php file and take away the identical line of code that you simply added to allow the restore utility.

In case your website nonetheless isn’t working, proceed onto the subsequent step.

Potential Repair 2: Verify Your Database Login Credentials

In case your database isn’t corrupt, the subsequent factor it’s best to examine is whether or not your database login credentials are working.

Your database credentials are outlined in your wp-config.php file:


If this info doesn’t match the database credentials that you simply created through your host’s dashboard, WordPress received’t have the ability to entry your database.

To check whether or not your database credentials are working, you need to use the mysql_connect() operate.

Use a textual content editor like Notepad to create a file known as databasecheck.php.

Then, add this code snippet to the file:

WP Saviour

I am a WordPress specialist. My mission is to help you create beautiful websites with ease!