Home / WordPress / Error When Activating a Plugin: Fix

Error When Activating a Plugin: Fix

Fix errors during plugin activation by checking PHP compatibility, missing dependencies, and activation hooks.

Views: 24 Unique: 17 Updated: 2026-03-18

What this problem is

Activating a plugin triggers an error, white screen, or returns you to the plugins page without activation.

Why it happens

  • PHP fatal error during activation
  • Plugin requires another plugin or PHP extension
  • Database changes fail due to permissions or timeouts

Prerequisites

  • Admin access (or FTP to roll back)
  • Error logs access

Diagnosis

Check wp-content/debug.log and server logs immediately after trying activation.

Detailed steps

Step 1) Verify plugin requirements

Confirm supported PHP and WordPress versions and required extensions.

Step 2) Increase memory/timeouts (temporary)

Some plugins run heavy migrations on activation.

Step 3) Activate with all other plugins disabled

Rule out conflicts by disabling other plugins first.

Step 4) Roll back safely if the site breaks

Disable the plugin folder via FTP.

Expected results

  • Plugin activates successfully, or a clear error indicates what to fix

What to do if it fails

  • Contact the plugin vendor with the exact log message
  • Try an older stable version if compatible

Best practices

  • Activate new plugins on staging first
  • Keep backups before activation of complex plugins
Back to category