The error "PCLZIP_ERR_MISSING_FILE (-4) : Missing archive file" appears in WordPress when a plugin or theme upload, update, or installation fails because WordPress can't write to or read from the temporary directory. The usual cause is the server's /tmp directory being full, your account hitting its disk quota, or a permissions issue.
Check Your Disk Space First
- cPanel > Disk Usage - make sure you're not at 100%
- Delete old backups, large log files, or unused themes/plugins to free space
- Try the upload/update again
01. What Causes This Error
- Disk quota full - your hosting account has no free disk space. WordPress can't extract the uploaded zip file. This is the #1 cause
- /tmp directory full - the server's temporary directory ran out of space. This is a server-side issue
- File too large - the plugin/theme zip file exceeds PHP's upload limit
- Corrupt zip file - the downloaded file is incomplete or damaged
- Permissions issue - the
wp-content/uploadsorwp-content/upgradedirectory isn't writable
02. How to Fix It
Step 1: Check Disk Space
Log into cPanel > Disk Usage. If you're at or near 100%, free up space by deleting old backups, clearing trash in email, removing unused themes and plugins, or clearing WordPress cache files.
Step 2: Re-download the File
If disk space is fine, the zip file may be corrupt. Download a fresh copy of the plugin or theme from the source (wordpress.org, the developer's site, etc.) and try uploading again.
Step 3: Check PHP Upload Limits
If the file is large (50MB+), check your PHP upload limits in cPanel > MultiPHP INI Editor. Increase upload_max_filesize and post_max_size to at least the size of the zip file.
Step 4: Fix Permissions
In cPanel > Terminal or via SSH:
chmod 755 ~/public_html/wp-content/uploads
chmod 755 ~/public_html/wp-content/upgradeStep 5: Use FTP Instead
If WordPress's built-in uploader keeps failing, upload the plugin/theme manually via FTP. Unzip the file on your computer, then upload the folder to wp-content/plugins/ or wp-content/themes/. See our FTP guide.
If the error mentions /tmp specifically and you have plenty of disk space, the server's temp directory may be full. Open a support ticket and we can check and clear it.
Still Getting This Error?
If none of the above resolves it, open a ticket with the exact error message and what you were trying to install/update.
Open a Support TicketFrequently Asked Questions
What causes the PCLZIP_ERR_MISSING_FILE error in WordPress?
It appears when a plugin or theme upload, update, or install fails because WordPress cannot write to or read from its temporary directory. The usual causes are a full server /tmp directory, your account hitting its disk quota, or a permissions issue.
How do I fix PCLZIP_ERR_MISSING_FILE (-4)?
Check that your account is not over its disk quota and free up space if it is, then retry the install. If space is fine, the server temporary directory may be full or misconfigured, so open a ticket and we can clear it from the server side.
Is PCLZIP_ERR_MISSING_FILE caused by a broken plugin?
Rarely. It is almost always a storage or temporary-directory problem rather than the plugin itself, since WordPress cannot stage the archive it needs to unpack. Freeing disk space usually resolves it, after which the same plugin installs fine.
How do I prevent this error from recurring?
Keep enough free disk space on your account, remove old backups and unused files, and avoid filling your quota. As long as WordPress has room to write its temporary files, the extraction step that fails here completes normally.
Quick Recap
- Check disk space - cPanel > Disk Usage, the #1 cause
- Re-download the zip - the file may be corrupt
- Increase PHP upload limits - for large plugins/themes
- Fix directory permissions - wp-content/uploads and wp-content/upgrade need 755
- Upload via FTP - as a workaround for the built-in uploader
Last updated November 2026 · Browse all WordPress articles
