Using the Media Manager to Organize Files in Joomla 6
β‘ Quick Answer
The Joomla 6 Media Manager lives under Content β Media in the admin panel. Upload files by dragging them into the window or clicking Upload, organize them into folders with the New Folder button, and insert any file straight into an article, module, or custom field via the Insert Media button in the editor β no FTP client required.
| What you'll need | Details |
|---|---|
| Joomla version | Joomla 6.0 or later (steps also apply to 6.1+) |
| Access level | Administrator or Super User login for the backend |
| Files to upload | Images, PDFs, or other media you plan to add to your site |
| Optional tools | An image compressor (TinyPNG, Squoosh) for optimizing photos before upload |
Joomla 6 ships with a modernized Media Manager: it generates thumbnails for every file type (not just images), adds drag-and-drop uploads, and lets you crop, resize, and rotate images without leaving the browser. This guide walks through accessing it, organizing files into folders, editing images inline, inserting media into content, and locking down permissions by user group.
Step 1: Open the Media Manager
Log in to your Joomla admin panel and go to Content β Media. This opens the Media Manager as a full built-in file browser β separate from any theme's own asset manager.
Step 2: Learn the Interface Layout
The Media Manager is split into three areas:
- Left panel β a folder navigation tree for jumping between directories.
- Main area β file thumbnails or a list view, depending on the toggle in the top-right corner.
- Toolbar β buttons to upload, create a folder, rename, move, or delete the selected item.
Switch between grid and list view depending on whether you're scanning images visually or checking file names and sizes.
Step 3: Upload Files
Click the Upload button, or simply drag files from your desktop and drop them into the Media Manager window. Joomla 6 accepts common formats including JPG, PNG, GIF, SVG, PDF, MP4, and ZIP by default (your host's upload size limit and Joomla's allowed file types in System β Global Configuration β Media still apply).
π‘ What's new in Joomla 6
The Media Manager now generates thumbnails for any file type β not just images β so PDFs, ZIPs, and documents show a recognizable preview icon instead of a blank placeholder, which makes large media libraries much faster to scan.
Step 4: Create and Organize Folders
Click the New Folder icon in the toolbar, give it a descriptive name (for example blog-images or banners), and click Create. Building a clear folder structure early β by content type, section, or year β keeps large sites manageable and makes it much faster to find a specific asset later.
Step 5: Rename, Move, or Delete Files
Select a file or folder, then use the toolbar to Rename or Move it into a different folder. To remove a file, select it and click the Trash icon.
β οΈ Before you delete
Deleting a file from the Media Manager also breaks any article, module, or custom field that references it β Joomla does not warn you automatically. Search your content for the file name before removing it.
Step 6: Preview and Edit Images Inline
Click any file thumbnail to open a preview. For images, Joomla 6's editor lets you crop, resize, and rotate directly in the browser, then save the changes without leaving the Media Manager β no external editor needed for basic touch-ups.
Step 7: Insert Media into an Article
Open any article in the editor and click the Insert Media (or Image) button below the text area. Browse to the right folder, select the file, and click Insert. From the same dialog you can set alt text, alignment, and a custom width or height before the image is placed in the content.
Step 8: Control Media Permissions by User Group
Go to System β Global Configuration β Media and open the Permissions tab. From here you can define what each user group is allowed to do β for example, letting Authors upload files but not delete them, while only Administrators get full control.
Best Practices for File Organization
- Use JPG for photos, and PNG or SVG for logos and icons.
- Compress images before upload with a tool like TinyPNG or Squoosh.
- Keep file names descriptive and lowercase (e.g.
joomla-dashboard-tutorial.jpg, notIMG_2481.jpg). - Use WebP if your template and browser support target allow it β smaller file size at similar visual quality.
- Group files by purpose (banners, blog-images, product-photos) instead of dumping everything into the root media folder.
β Frequently Asked Questions
Where is the Media Manager in Joomla 6?
Go to Content β Media in the admin panel. It's a built-in file browser, so no extension installation is required.
What file types can I upload?
Joomla 6 accepts common formats by default, including JPG, PNG, GIF, SVG, PDF, MP4, and ZIP, subject to the allowed file types set in Global Configuration β Media.
Can I edit images without leaving Joomla?
Yes. Click a thumbnail to preview it, then use the built-in tools to crop, resize, or rotate the image and save changes directly β no external software needed for basic edits.
What happens if I delete a file that's used on my site?
Any article, module, or custom field referencing that file will show a broken image or link. Joomla doesn't check usage before deleting, so search your content first.
How do I stop certain users from deleting media?
Go to Global Configuration β Media β Permissions and set the Delete action to Denied for the relevant user group, while leaving Upload allowed if they still need to add files.
Does Joomla 6 generate thumbnails for non-image files like PDFs?
Yes β this is new in Joomla 6. The Media Manager now creates recognizable thumbnails for any file type, not only images, making large media libraries easier to scan.
π§― Common Mistakes to Avoid
- Deleting files without checking usage first β always search your content for the file name before removing it from the Media Manager.
- Dumping everything into the root folder β without subfolders, large sites become impossible to navigate within a few months.
- Skipping alt text on insert β it's right there in the Insert Media dialog; leaving it blank hurts both accessibility and image search visibility.
- Uploading uncompressed originals β a 6 MB photo straight from a phone or DSLR will slow down every page it appears on.
- Giving every user group full delete permissions β restrict Delete to trusted roles via the Permissions tab to avoid accidental content loss.
β‘οΈ What's Next
Once your files are organized, the next step is making sure they're actually fast to load β see our guide on optimizing images for Joomla 6 performance. If you're still working through the basics, the Joomla 6 Newbie Guide covers the full admin dashboard and article workflow.
Joomla 6 Hosting Requirements: PHP, Database & Server Checklist