How to disable a WordPress plugin via FTP

When a plugin conflict causes a “Fatal Error” or the “White Screen of Death,” you are often locked out of the WordPress admin dashboard (the backend). In these cases, you can use the mybox infrastructure’s file access to manually “deactivate” the faulty plugin by renaming its folder.

WordPress looks for plugins in specific folders. If you change the name of a plugin’s folder, WordPress will fail to find it and automatically skip loading it, effectively disabling the plugin without deleting any data.

Step 1: Identify the Faulty Plugin

Before disabling anything, you need to know which plugin is causing the crash. You can do this by enabling WP_DEBUG in your wp-config.php file (located in your public_html folder).

1. Connect to your server via FTP or SFTP.
2. Edit wp-config.php and change define( 'WP_DEBUG', false ); to true.
3. Refresh your website. Look for a “Fatal error” or “Parse error” that contains a path like this: .../wp-content/plugins/plugin-name/filename.php

The folder name immediately following /plugins/ is the one you need to target.

Step 2: Disable the Plugin via FTP

Once you have identified the culprit (e.g., a plugin named hello-dolly), follow these steps:

1. In your FTP client (like FileZilla or WinSCP), navigate to the directory: yourdomain.com/public_html/wp-content/plugins/
2. Locate the folder belonging to the faulty plugin.
3. Right-click the folder and select Rename.
4. Add a suffix to the name, such as .old or .off (e.g., rename hello-dolly to hello-dolly.off).
5. Save the change.

Step 3: Verify and Cleanup

After renaming the folder, try to load your website or the /wp-admin login page again. If that plugin was the sole cause of the crash, the site should now load normally.

• Login to WordPress: You will see a notification in the “Plugins” section stating that the plugin has been deactivated because “the file does not exist.”
• Reverting: If you want to try fixing the plugin or updating it, you can simply rename the folder back to its original name.
• Disable Debugging: Once the site is back up, remember to go back into wp-config.php and set WP_DEBUG back to false to keep your site’s technical details hidden from public view.

Distinction Block

Deactivate vs. Delete Renaming the folder deactivates the plugin but keeps all its files and settings safe. Deleting the folder removes the plugin entirely from your mybox server. It is always safer to rename first.

Practical Implications

• Bulk Deactivation: If you don’t know which plugin is the problem and the error message isn’t specific, you can rename the entire plugins folder to plugins.old. This will disable all plugins at once, allowing you to see if the core site still works.
• Theme Conflicts: The same logic applies to themes. If your theme is broken, you can find it in wp-content/themes/ and rename its folder to force WordPress to revert to a default theme (like Twenty Twenty-Four).
• Caching: After renaming a folder, you might need to clear your browser cache or any server-side caching (like LiteSpeed or Varnish) to see the changes immediately.

Summary

Disabling a plugin via FTP is the “emergency brake” for WordPress. By renaming the plugin folder in the mybox file system, you bypass the broken code and regain access to your website’s backend.