WordPress Troubleshooting
Guide 2026

📋 Common WordPress Errors at a Glance

Use this table to quickly identify your error and jump to the right fix.

🛡️ Before You Start: Back Up First

Every hosting platform offers a way to back up. Here's where to find it on the major ones:

• ✓cPanel hosts (Bluehost, HostGator, SiteGround, etc.): cPanel → Backup Wizard or JetBackup
• ✓WP Engine: Sites → your site → Backup Points → Create New Backup Point
• ✓Kinsta: Dashboard → Backups → Download
• ✓Cloudways: Application → Backup & Restore → Create Backup
• ✓Flywheel / Local: Sites → Backups → Create Backup
• ✓Any host: Install UpdraftPlus and run a manual backup now

🔍 Step 1: Enable WordPress Debug Mode

Debug mode reveals hidden error messages that point you directly to the problem. This is the single most important troubleshooting step.

How to Access wp-config.php

👻 The White Screen of Death (WSOD)

A blank white screen in WordPress — with no error message — means PHP encountered a fatal error but debug mode is off. Here's how to diagnose and fix it.

💥 500 Internal Server Error

The 500 error means something went wrong on the server, but it won't tell you what. The three most common causes are a corrupted .htaccess file, exhausted PHP memory, or a broken plugin/theme.

Fix 1: Reset .htaccess

This is the most common cause. Via FTP, rename .htaccess to .htaccess_old, then go to Settings → Permalinks in your dashboard and click Save Changes to regenerate a clean one.

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Fix 2: Increase PHP Memory via .htaccess

php_value memory_limit 256M
php_value max_execution_time 300
php_value upload_max_filesize 64M
php_value post_max_size 64M

🗄️ Error Establishing a Database Connection

This error means WordPress cannot connect to your MySQL database. It could be wrong credentials, a crashed database server, or corrupted tables.

Step 1: Verify Credentials in wp-config.php

// These MUST match exactly what's in your hosting panel
define( 'DB_NAME',     'your_database_name' );  // check cPanel → MySQL Databases
define( 'DB_USER',     'your_db_username'   );
define( 'DB_PASSWORD', 'your_db_password'   );
define( 'DB_HOST',     'localhost'           );  // try 127.0.0.1 if localhost fails

Step 2: Use phpMyAdmin to Check the Database

Step 3: Use the WordPress Database Repair Tool

Add this line to wp-config.php, then visit the repair URL. Remove it immediately after use.

define( 'WP_ALLOW_REPAIR', true );

// Then visit: https://yoursite.com/wp-admin/maint/repair.php

🔐 WordPress Login & Lock-out Issues

Can't access your WordPress dashboard? Here are three escalating methods to regain access — try them in order.

Method 1: Reset Password by Email

Go to yoursite.com/wp-login.php and click "Lost your password?" Enter your email or username and check your inbox for a reset link.

Method 2: Reset Password via phpMyAdmin

Method 3: Fix Incorrect Site URL (causes redirect loops)

// Force the correct URLs — remove after you fix in Settings
define( 'WP_HOME',    'https://yoursite.com' );
define( 'WP_SITEURL', 'https://yoursite.com' );

🧩 Diagnosing Plugin & Theme Conflicts

Plugin conflicts are the #1 cause of WordPress issues. The method below isolates the problem without losing your content or settings.

Systematic Conflict Isolation

💾 PHP Memory Limit Errors

WordPress processes use PHP memory. When the limit is exceeded, you get a blank screen or an error saying "Allowed memory size exhausted." Fix it by increasing the limit.

Method 1: Via wp-config.php (Works Everywhere)

define( 'WP_MEMORY_LIMIT', '256M' );         // for front-end
define( 'WP_MAX_MEMORY_LIMIT', '512M' );      // for admin area

Method 2: Via php.ini (VPS/Dedicated)

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
max_input_vars = 3000

Verify Your Current Memory Usage

Install the Query Monitor plugin and look at the "Overview" tab — it shows PHP memory usage per page load.

📄 .htaccess & Permalink Issues

Broken permalinks or 404 errors on posts/pages (while the homepage works) are nearly always a .htaccess problem.

Quick Fix: Flush Permalinks

📁 Media Upload Errors

Can't upload images or files? There are two common culprits: file size limits, and wrong folder permissions.

Fix 1: Increase Upload Size Limits

php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 300
php_value max_input_time 300

Fix 2: Fix /wp-content/uploads/ Permissions

chmod 755 wp-content/uploads/
find wp-content/uploads/ -type d -exec chmod 755 {} \;
find wp-content/uploads/ -type f -exec chmod 644 {} \;

# If you see "HTTP error" on image upload, also run:
chown -R www-data:www-data wp-content/uploads/

🔒 SSL & Mixed Content Warnings

If your site has HTTPS but shows a padlock with a warning, mixed content is the problem — some resources are still loading over HTTP.

Fix: Update URLs in the Database

Use the Better Search Replace plugin, or run this SQL query in phpMyAdmin:

-- Run this AFTER taking a full database backup
UPDATE wp_options  SET option_value = replace(option_value, 'http://yoursite.com', 'https://yoursite.com');
UPDATE wp_posts    SET post_content = replace(post_content,  'http://yoursite.com', 'https://yoursite.com');
UPDATE wp_postmeta SET meta_value   = replace(meta_value,    'http://yoursite.com', 'https://yoursite.com');

Force HTTPS in wp-config.php

define( 'FORCE_SSL_ADMIN', true );

// If behind a load balancer or reverse proxy (Cloudflare, etc.):
if ( isset( $_SERVER['HTTP_X_FORWARDED_PROTO'] ) && $_SERVER['HTTP_X_FORWARDED_PROTO'] == 'https' ) {
    $_SERVER['HTTPS'] = 'on';
}

🏠 Hosting-Specific Tips

Every major hosting platform has its own tools and quirks. Here's what you need to know for each one.

❓ Frequently Asked Questions

Quick answers to the most common WordPress troubleshooting questions.