How to troubleshoot uploading a WordPress plugin ZIP file

Updated on September 23, 2025

When uploading a plugin ZIP file to WordPress, you may experience issues such as the screen locked on “Installing plugin from uploaded file”. When refreshing it may say link expired. Try these troubleshooting steps.

Troubleshooting Steps

  1. Confirm your ZIP file is packaged correctly

    The ZIP file should contain a single folder that has the same name as the plugin. That folder should contain the plugin files.

  2. Check upload limits.

    A very large plugin could cause timeout issues with your host. If so, it may be possible to increase upload limits depending on your hosting provider.

  3. Check whether you are in maintenance mode.

    Check your site with an incognito window. If the site says something like “Briefly unavailable for scheduled maintenance…”, then you are in maintenance mode. Try deleting the file ".maintenance" in your WordPress directory.

  4. Try clearing your browser and server caches.

  5. Confirm the plugins folder is writable by WordPress

    From the side menu, select Tools > Site Health > Filesystem Permissions and confirm writeable is listed.

  6. If no luck so far, manually upload the plugin.

Reference

See also

License

Licensed under CC BY 4.0

You are free to share and adapt this content for any purpose as long as you give appropriate credit in a reasonable manner.

No affiliate links

We do not participate in affiliate marketing, and we are not paid to mention products.

Leave a Reply

Your email address will not be published. Required fields are marked *