Joomla! World Conference 2026

Starting with Joomla 5.3, you can upload files to a dedicated files folder instead of the images folder. It may look like a small difference, but it is a big improvement in terms of usability and site structure. 

Until now, by default Joomla had only the /images folder in the Media manager for upload. That meant: when you (or your users) wanted to upload PDF files or other documents, they would go into the images folder, or a subfolder in the images folder (for example: /images/files). 

You could, of course, create a folder yourself for uploads, but you need a little geeky knowledge for that. So for regular site administrators or content managers, that’s not an option. 

Usually people settle for creating a subfolder within /images, which is really easy. But then the path to the file would have /images in it somewhere (yourwebsite/images/files/yourfile), and that doesn’t feel right for everyone. An image is an image, and a code of conduct, terms of service or whatever other document is not. They’re files and it’s just not logical to place them in a folder called “images” even if that folder has a subfolder.

New files folder in Joomla 5.3 

In Joomla 5.3, another folder is added so you can choose the destination folder for your files: /images or /files. You don’t have to configure anything for it, this works out of the box on new installations (for the techies: the plugin  “FileSystem - Local” now has both folders configured by default). 

The folder list in the Media Manager
In the Media Manager, you’ll see the new folder.

Updating existing websites

You probably wonder if this only applies to new 5.3 installations or if it can be used on updated sites as well. Existing installations will also have the new folder, with no files in it yet. If you want to use it, take the following steps after updating to Joomla 5.3:

In the Media component, set Path to Files Folder option to files;
Go to System -> Plugins and find the FileSystem - Local plugin. Add files to the list of directories (images is already there). 

And that’s it: now you can use the files folder to upload your files.

About the author

Before I got my current job as Coordinator Communications & Digital, I ran my own company for 25 years. The first 15 years I was a writer / editor / journalist / writing coach, but then I created my first website with Joomla... and I was hooked. I switched careers and became a website developer. My current job combines these two skills, so that's a win-win 🙂 

Anja's Holopin board

Why I contribute to Joomla

To many people Joomla is just a tool. But if you look a little closer, you'll notice it's much more than that. It's a living system, raised and nourished by a community of volunteers dedicating their time to make it the best CMS ever. Without volunteers, Joomla wouldn't exist. It's not 'just a product'. Everyone who uses Joomla, can do so because someone, somewhere, contributed to it. I want to give back to the community that keeps Joomla alive.

And, probably needless to say: I love being part of that community. 

Contributing to Joomla by volunteering brought me so much: valuable experience, more knowledge and a better understanding of Joomla and its community, and the opportunity to work together with a crowd of lovely people all over the world.

Visit website

Some articles published on the Joomla Community Magazine represent the personal opinion or experience of the Author on the specific topic and might not be aligned to the official position of the Joomla Project

Comments