“The uploaded file exceeds the upload_max_filesize directive”

Why WordPress rejects large uploads, how to check the current limit, and the options for uploading files bigger than it.

TroubleshootingBeginner2 min readUpdated

Does this match what you’re seeing?

  • WordPress says the uploaded file exceeds the upload_max_filesize directive
  • Theme or plugin zip uploads fail
  • The media library shows a maximum upload size that’s too small

PHP limits the size of a single upload with upload_max_filesize, and the whole request with post_max_size. WordPress shows the effective limit in Media → Add New.

Option 1: raise the limit

Check whether these settings can be changed for your account, and raise both together — post_max_size must be at least as large as upload_max_filesize. Changing PHP settings: memory_limit, upload size and execution time

Option 2: upload another way

Big files don’t need to go through WordPress’s uploader.

  • Themes and plugins: unzip on your computer and upload the folder into wp-content/themes or wp-content/plugins using the File Manager or SFTP. How to upload and extract a zip file
  • Media: upload to wp-content/uploads via SFTP, then use a media-import plugin to register them in the library.

Option 3: make the file smaller

  • Images straight from a camera are often 5–10MB. Resize to the largest size your site displays and compress them. How to optimise images for a faster website
  • Video belongs on a video platform, embedded in the page. It uses your 3GB and bandwidth quickly otherwise.

Everything in this guide works on Traxio’s WordPress hosting: 30 days free, then £0.99 a month.

Popular

Tip: press / to search from any pageSee all results