The size of files available for upload through the Contao File Manager is controlled by two possible settings - the Contao System Settings for upload and the file upload size limit in the PHP.INI file.  By default the limit in the PHP.INI file is set to 128 MB and a default installation of Contao will have the setting at 2 MB.  The following article shows you the error you will encounter if you exceed this limit, and how to fix it in both the Contao System Settings and PHP.INI file.


Increasing the Contao File Manager Upload Limit

File Upload exceeds file size limitDuring the upload of files with the Contao File Manager you may see the error message at right. 

  1. Login to the Contao Back end as an Administrator.
  2. In the left hand section labeled Back end modules, scroll down until you find SYSTEM. Click on SETTINGS and it will launch the Contao System Settings screen.
  3. System Settings for uploading filesIn the SETTINGS screen, scroll down until you find the UPLOAD SETTINGSsection.  Click on the arrow at left in order to expand the section if you need to have it expanded.
  4. Look for the field labeled MAXIMUM UPLOAD FILE SIZE. Click in the field and change the file size which uses bytes as the units. By default, the value is set to 2048000 bytes (2 MB).  If you want to calculate to the exact byte, multiply 1024 (1 MB) times the number of megabytes you want to use.  For example, 4 MB would 4096000 bytes.  
  5. Click on SAVE AND CLOSE in the bottom left hand side of the SETTINGS window.


If you are attempting to exceed 128 MB, you will need to find the default PHP.INI file and change the FILE UPLOAD size that is set in the file.  Web Hosting Hub includes a default PHP.INI file at the root PUBLIC_HTML folder.  You can edit this file using the Cpanel File Manager or your by downloading with a FTP client and then editing the file with a text editor.  After editing the file you would need to re-upload the file and replace the old PHP.INI with the modified one.  For more information on editing through Cpanel, go to  Using the Cpanel File Manager.  You can also find information using Notepad ++'s FTP solution here:  Using Notepad++ to Modify a File.

Here is a summary of the steps to edit the PHP.INI file:

  1. Access the PHP.INI file in your web host using Cpanel File Manager or through FTP.  By default, the file is often at the root of the primary domain - public_html.
  2. Open the file with the editor and look for the following section:
    PHP.INI file File Uploadds section

  3. Look for the UPLOAD_MAX_FILESIZE line and change the limit there.  Remember that you will still need to be set in the Contao System settings. 
  4. Click on SAVE in order to save your settings.


This will change the size of the files allowed to be uploaded through the File Manager and the Contao File Manager.  Bear in mind that while file sizes can be used, the acutal size used should be limited per your server performance needs.  You do not want to be loading 16 MB graphic files, and expecting the performance of the server to optimal at that poin.  Keep the file sizes small and there should be no issues with the File Upload sizes.


Did you find this article helpful?

We value your feedback!

Why was this article not helpful? (Check all that apply)
The article is too difficult or too technical to follow.
There is a step or detail missing from the instructions.
The information is incorrect or out-of-date.
It does not resolve the question/problem I have.
How did you find this article?
Please tell us how we can improve this article:
Email Address

new! - Enter your name and email address above and we will post your feedback in the comments on this page!

Did you find this article helpful?

Post a Comment

Email Address:
Phone Number:

Please note: Your name and comment will be displayed, but we will not show your email address.

Related Questions

Here are a few questions related to this article that our customers have asked:
Ooops! It looks like there are no questions about this page.
Would you like to ask a question about this page? If so, click the button below!

Help Center Search

Current Customers

Email: Ticket: Submit a Support Ticket
Call: 877-595-4HUB (4482)
757-416-6627 (Intl.)
Chat: Click To Chat Now

Ask the Community

Get help with your questions from our community of like-minded hosting users and Web Hosting Hub Staff.

Not a Customer?

Get web hosting from a company that is here to help.