ON THE day a client first attempts to upload a large video file to their new WordPress site, they often encounter the frustrating "maximum upload size exceeded" error. It was a wake-up call, observed the site owner. Many web professionals say that even experienced users, a group familiar with themes and plugins, are "caught off guard" by the PHP upload limits that govern their server.
This limit isn't set by WordPress itself, but by your server's PHP configuration. When you try to upload an image, theme, or plugin file that's larger than this hidden ceiling, the process fails silently or with a clear error. Understanding and adjusting this is a fundamental step in taking full control of your website's functionality, much like learning to customize your site's typography to match your brand's voice.
How to Increase the Maximum Upload Size in PHP
Increasing the PHP upload limit might sound technical, but it's often a straightforward process. You have a few different paths to try, starting with the simplest methods within WordPress before moving to more direct server configurations. The goal is to modify key PHP settings: upload_max_filesize, post_max_size, and sometimes memory_limit and max_execution_time for very large files. Let's walk through the most common solutions.
- Method 1: Use a WordPress Plugin: The easiest way for beginners is to use a dedicated plugin. Search for "increase max upload size" in your WordPress dashboard's plugin repository. These plugins often add a simple settings page to your admin area where you can adjust the limits with a dropdown menu, though their effectiveness depends on your hosting environment.
- Method 2: Edit the functions.php File: You can add a small code snippet to your theme's functions.php file. This method tells PHP to use higher values. Always use a child theme when doing this to prevent your changes from being overwritten during a theme update. A common snippet looks like:
@ini_set( 'upload_max_size' , '64M' );and@ini_set( 'post_max_size', '64M');. - Method 3: Modify the .htaccess File (For Apache Servers): If your hosting uses the Apache server, you can add directives to your site's root .htaccess file. Use your hosting file manager or FTP to find this file (it's usually hidden) and add lines like:
php_value upload_max_filesize 64Mandphp_value post_max_size 64M. Remember to back up the file first. - Method 4: Create or Edit a php.ini File: The most direct method is to create or edit a php.ini file in your WordPress root directory. If one doesn't exist, create a text file and name it php.ini. Inside, add the lines:
upload_max_filesize = 64M,post_max_size = 64M. This method gives you the most control but requires checking with your host if they allow it. - Method 5: Contact Your Hosting Provider: If the above methods don't work, your hosting plan may have strict limits. Reaching out to your host's support team is the final and most reliable step. They can often increase these limits from their main server configuration, especially if you are moving to a new host and need to transfer a large site archive during the process.
What is the default max upload size in WordPress?
The default maximum upload size in WordPress is not a fixed number set by the software. It is inherited from your web server's PHP configuration. Most shared hosting providers set this limit between 2MB and 8MB as a standard starting point. You can check your current limit by navigating to Dashboard > Media > Add New. The limit is displayed under the upload button. This size is usually sufficient for standard images but can be a major obstacle for uploading high-resolution photography, video files, premium themes, or large plugin packages, necessitating an increase.
Why is my upload limit still small after changing php.ini?
If you've changed your php.ini or .htaccess file but see no change, several factors could be at play. First, your hosting provider might be using a master php.ini that overrides your local file, especially on shared hosting. Second, there could be a syntax error in your configuration file causing it to be ignored. Third, you may need to restart your web server for changes to take effect, though this is rare on shared hosts. Finally, check if your hosting control panel (like cPanel) has its own PHP configuration editor that applies settings globally; using that tool is often more effective. Persisting issues are a good reason to consider professional WordPress hosting migration assistance to a more flexible environment.
Can I increase max upload size without accessing cPanel?
Yes, you can increase the upload limit without cPanel access. The most common method is by adding code to your theme's functions.php file or by using a dedicated WordPress plugin designed for this purpose. The plugin method is the most user-friendly, as it provides an interface within your WordPress admin. However, its success depends on your host's permissions. Editing functions.php is a more direct code-based approach. If neither works, your final recourse is to contact your hosting support directly. They can make the change on the server side, which is also a step you'd encounter if you ever needed to restore a WordPress site from a full backup that exceeds the default limits.
What's the difference between upload_max_filesize and post_max_size?
These are two distinct but related PHP settings. The upload_max_filesize directive sets the maximum size for a single file being uploaded. The post_max_size sets the total allowed size for the entire POST request, which can include the file plus any form data. For proper functioning, post_max_size should be set slightly larger than upload_max_filesize. If they are equal, the combined overhead of the request might cause it to fail. Think of it like mailing a package: one limit is for the item inside (the file), and the other is for the total weight of the box, packing, and label (the entire request). Properly configuring these is as important for site management as choosing the right tools, like a responsive table plugin for WordPress to handle data presentation.
Will increasing PHP limits affect my site's security or speed?
Increasing these limits alone has a minimal direct impact on security or speed. The primary risk is allowing users to upload extremely large files that could fill up your server storage if not monitored. It does not make your site more vulnerable to code-based attacks. Performance is only affected during the actual upload process of a large file; general site speed remains unchanged. However, it's a best practice to only increase the limits to what you realistically need. For example, if you only upload images, 64MB is plenty. For comprehensive site management, pairing this with other best practices like implementing a free ADA compliance plugin for WordPress ensures your site remains robust and accessible.
How do I handle large file uploads for clients?
Handling large uploads for client sites requires a clear process. First, diagnose the current limit using the Media Library screen. Then, apply the simplest solution, often starting with a plugin or functions.php snippet. If those fail, proceed to server-level files (.htaccess or php.ini). Always communicate with the client about the changes made. For ongoing management, consider setting up a staging site to test increases safely. A key part of professional service is ensuring all elements transfer correctly, which includes understanding how plugin licenses are handled during a website migration to avoid service interruptions. Documenting the solution for the client is also a valuable step.
Promoting WordPress Services at WPutopia
At WPutopia, we understand that technical hurdles like upload limits can disrupt your workflow and slow down your projects. That's why our WordPress maintenance services include handling these server configurations for you. We proactively monitor and adjust key PHP settings, along with performing core, theme, and plugin updates, to keep your site running smoothly and securely. You can focus on creating content and growing your business, leaving the technical details to our team.
Beyond routine maintenance, we offer specialized upgrades and installations. Whether you need a custom theme implemented, a complex plugin like a <
