WordPress errors come in all shapes and sizes. In most cases they’re easy to decipher; such is the accessibility of WordPress’ error reporting. Even so, when the “413 Request Entity Too Large” error pops up, it can leave you scratching your head.
Without realizing it, you already have everything you need to understand and diagnose the error within its name. The good news is you won’t need more than a standard Secure File Transfer Protocol (SFTP) client and administrator access to your server.
In this post, we’ll take a look at how to solve the “413 Request Entity Too Large” error. We’ll also give you a quick list of steps to take before you begin to solve the error, to make the process super straightforward.
Check out our video guide to fixing the “413 Request Entity Too Large” Error
What the “413 Request Entity Too Large” Error Is (And Why It Exists)
We noted that there’s a clue in the error name as to what the solution and problem are. Before you go sleuthing yourself, though, we’ll spoil the surprise: it’s in the adjective “large.”
In a nutshell, the “413 Request Entity Too Large” error is a size issue. It happens when a client makes a request that’s too large for the end server to process. Depending on the nature of the error, the server could close the connection altogether to prevent further requests being made.
Let’s break the error down into its parts:
- “413”: This is one of the 4xx error codes, which mean there’s a problem between the server and browser.
- “Request Entity”: The “entity” in this case is the information payload being requested by the client from the server.
- “Too Large”: This is straightforward: the entity is bigger than the server is willing or able to serve.
In fact, this error has changed its name from what it originally was to be more specific and offer more clarity. It’s now known as the “413 Payload Too Large” error, although in practice, you’ll see the older name a lot more.
As for why the error occurs, the simple explanation is that the server is set up to deny explicit uploads that are too large. Think of times when you upload a file where there’s a maximum file size limit:
In most cases, there will be some validation in place to stop the error… if you’re seeing the “413 Request Entity Too Large” error, those validation efforts may not be as watertight as you think.
What You’ll Need to Resolve the “413 Request Entity Too Large” Error
Fixing this error is all about raising the maximum file size for the server in question. Once that’s out of the way, you shouldn’t see the error anymore.
As such, to fix the “413 Request Entity Too Large” error, you’ll need the following:
- Administrator access to your server.
- A suitable SFTP client (we’ve covered many of these in the past).
- The know-how to use SFTP — there’s a good guide to the basics on WordPress.org, and you won’t need more than that.
- A text editor, though there’s no need for anything too complex.
- A clean and current backup in case the worst happens.
As an aside, we mention SFTP throughout this article as opposed to FTP. In short, the former is more secure than the latter (hence the name). That said, while there are other differences you should investigate, the functionality remains the same for the vast majority of uses.
Also, it’s worth noting that the MyKinsta dashboard has plenty of functionality on hand to help you get onto your server. For example, each site displays SFTP connection information that’s easy to understand:
This can help you get into your site without fuss. In some cases, you may be able to import the credentials straight to your chosen SFTP client.
3 “Pre-Steps” You Can Take Before Rectifying the “413 Request Entity Too Large” Error
Before you crack open your toolbox, there are some steps you can take to help resolve the “413 Request Entity Too Large” error. Here are two — and each one may give you a welcome workaround to the error.
1. Try to Upload a Large File to Your Server Through SFTP
Because the issue is related to the file sizes hitting your server, it’s a good idea to circumvent the frontend interface and upload a large file to the server yourself. The best way to do this is through SFTP.
This is because protocols such as SFTP are almost as “close to the bone” as you can get with regards to the way you access your server. Also, you can simultaneously rule out any issues with the frontend that may be causing the error.
To do this, log into your site through SFTP and find the wp-content folder. In here will be the uploads folder.
Next, upload your file to this folder on the server and see what the outcome is. If the upload is successful, we suggest sending an email to the site’s developer, as they may want to investigate the issue further on the frontend.
2. Check for Server Permissions Errors
Of course, permissions errors will stop any server request from running. As such, you should check whether the user has sufficient permissions to upload files of any size. Once this is sorted, the error should disappear.
The first step is to determine whether this is an issue with a single user (in which case they may be restricted for a reason). If the “413 Request Entity Too Large” error is happening for multiple users, you can be more sure of something that needs your input.
We’d suggest two “pre-fixes” here:
- Double-check your WordPress file permissions, just in case there’s an issue.
- Remove and re-create your SFTP user (a general investigation is a great idea).
While they may not solve the error in the first instance, you’ll at least know that your file and user structure is as it should be.
How to Solve the “413 Request Entity Too Large Error” for Your WordPress Website (3 Ways)
Once you’ve gone through the pre-steps, you’re ready to tackle the error head-on.
The following three methods are listed from easiest to toughest, with the understanding that that the path of least resistance is the best one to take.
1. Edit Your WordPress functions.php File
First off, you can work with your functions.php file to help bump up the file upload size for your site. To do this, first log into your site through SFTP using the credentials found within your hosting control panel.
When you’re in, you’ll want to look for the file itself. The functions.php file should be in the root of your server. In many cases, this root is called www or public_html, or it could be the abbreviated name of your site.
Once you’ve found it, you can open it in your text editor of choice. If you don’t see the file, you can create it using your text editor.
Once you have a file open, enter the following:
@ini_set( '_max_size' , '64M' ); @ini_set( 'post_max_size', '64M'); @ini_set( 'max_execution_time', '300' );
In short, this increases the maximum file size of posts and uploads while boosting the time the server will spend trying to process the request. The numbers here could be anything you wish, but they should be large enough to make the error disappear. In practice, 64 MB is enough for all but the most heavy-duty of tasks.
When you’re ready, save your file and upload it to the server again. Then, check whether the “413 Request Entity Too Large” error still exists. If it does, head onto the next method.
2. Modify Your WordPress .htaccess File
Much like your functions.php file, your .htaccess file sits on your server. The difference here is that .htaccess is a configuration file for Apache servers. If you’re a Kinsta customer, you’ll know we run Nginx servers, so you won’t see this file in your setup.
Still, for those with an Apache server, this is the approach you’ll need. Much like with the guidance for functions.php, first log into your server through SFTP, then look in your root folder as before.
The .htaccess file should be within this directory, but if it’s missing, we suggest you get in touch with your host to determine where it is, and whether your server runs on Nginx instead.
Once you’ve found it, open it up again. You’ll see some tags, and the most important here is
# END WordPress. You’ll want to paste the following after this line:
php_value upload_max_filesize 64M php_value post_max_size 64M php_value max_execution_time 300 php_value max_input_time 300
In short, this does almost the same thing as the code you’d add to the functions.php file, but it’s akin to giving the server direct instructions.
When you’ve finished, save your changes, upload the file, and check your site again. If you’re still having trouble, we’d again suggest contacting your host, as they will need to verify some aspects of your setup that lie beyond the scope of this article.
3. Change Your Nginx Server Configuration
Our final method is specific to Nginx servers — those used at Kinsta. The purpose is the same as when working with the .htaccess file, in that you’re talking to the server, rather than going through WordPress.
We mentioned that for Apache servers you’ll use .htaccess. For Nginx servers, though, you’ll want to find the nginx.conf file. Rather than walk you through every step in the chain, we’ve gone over the full details in our post on changing the WordPress maximum upload size.
Remember that you’ll need to also alter the php.ini file based on the changes you make to nginx.conf. We’ve covered that in the aforementioned blog post too, so take a look there for the exact steps.
Despite WordPress being a rock-solid platform, you’ll see a lot of different WordPress errors over time. The “413 Request Entity Too Large” error is related to your server, though — not WordPress. As such, there’s a different approach to solving this error than other platform-specific issues.
If you have SFTP skills, there’s no reason you can’t fix this error quickly. It relates to the upload size specified in your server configuration files, so digging into your .htaccess or nginx.config files will be necessary. It’s a breeze to crack open your text editor and make the changes to these files, and if you’re a Kinsta customer, we’re on hand to support you through the process.