Back to Community
Home / Community / Plugin → Wpforms

Troubleshooting Common WPForms Installation and Update Errors

47 threads Sep 16, 2025 Plugin → Wpforms

Content

Encountering errors while installing or updating the WPForms plugin is a common frustration for many WordPress users. These issues can range from cryptic permission errors to failed downloads that leave your site in a broken state. This guide will walk you through the most frequent causes and their solutions, helping you get your forms back online.

Common WPForms Installation & Update Errors

Based on community reports, the most prevalent issues include:

  • "Update failed: Could not create directory"
  • "cURL 28" timeout errors during update
  • Fatal PHP errors after an update (e.g., "Cannot redeclare function")
  • Plugin appears to install or reactivate itself automatically
  • General failure to install or activate the plugin

Why Do These Errors Happen?

These problems are rarely due to a bug in the WPForms plugin itself. Instead, they are almost always caused by factors within your specific WordPress hosting environment. The primary culprits are:

  1. File Permissions: Your web server's user (e.g., www-data) does not have write permissions to the wp-content directory. This prevents it from creating the necessary folders to install or update plugins, leading to the "Could not create directory" error.
  2. Insufficient Disk Space: If your hosting account is out of space, the server cannot complete the download and extraction of the new plugin files.
  3. Server Configuration Limits: Low PHP memory limits, short max_execution_time, or restrictive security modules (e.g., mod_security) can interrupt the update process, causing timeouts (cURL 28 errors) or failed installations.
  4. Incomplete Updates: A plugin update can be interrupted by a lost connection, leaving behind a partial installation. This often results in fatal PHP errors because required files are missing or corrupted.
  5. Hosting Pre-Installations: Some web hosts pre-install certain plugins. If you manually remove one that the host's system is trying to manage, it can lead to errors like "Plugin file does not exist" even after deletion.

Step-by-Step Troubleshooting Guide

Follow these steps to resolve installation and update issues.

Step 1: Basic Checks

  • Check Disk Space: Contact your hosting provider to confirm you are not out of disk space.
  • Check File Permissions: Verify that the wp-content directory and all folders within it are writable. Typically, directories should be set to 755 and files to 644. Your hosting provider can help with this.

Step 2: Manual Plugin Reinstallation (Most Effective Solution)

If an update fails and causes a fatal error, a clean manual reinstall is often the fastest fix.

  1. Deactivate and Delete: In your WordPress admin, go to Plugins, deactivate WPForms, and then delete it. Do not worry; this will not delete your existing forms, as that data is stored in your database.
  2. Download a Fresh Copy:
    • For WPForms Lite: Download the latest version directly from the WordPress Plugin Directory.
    • For WPForms Pro/Paid: Log into your account on the WPForms website and download the plugin zip file from there.
  3. Install Manually: In your WordPress admin, go to Plugins > Add New > Upload Plugin. Upload the zip file you just downloaded, install it, and activate it.
  4. Re-enter License Key (Paid Versions): Go to WPForms > Settings to re-verify your license key for updates and support.

Step 3: Conflict and Configuration Testing

If manual reinstallation doesn't work, the issue may be a server configuration or conflict.

  • Increase PHP Limits: Temporarily increase your PHP memory limit (to 256M or 512M) and max_execution_time (to 300) in your php.ini file or via your hosting control panel. Try the update again.
  • Check for Hosting Pre-Installs: If the plugin seems to "reinstall itself," contact your hosting provider to ask if WPForms is part of a pre-installed package they manage.

When to Seek Further Help

If you have followed all the steps above and the problem persists, the issue is likely highly specific to your server environment. Your next step should be to contact your web hosting provider's support team. They can check server-level error logs, review security rules, and confirm that all system requirements are properly configured for running WordPress plugins.

For users of paid versions of WPForms, the WPForms team provides direct support through the account dashboard on their website.

Related Support Threads Support