🏠 Home πŸ–₯️ Hosting 🎨 Themes πŸ”Œ Plugins πŸ› οΈ Dev Tools ⚑ WordPress πŸ”₯ Joomla!
Tutorial

Using the Media Manager to Organize Files in Joomla 6

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 needDetails
Joomla versionJoomla 6.0 or later (steps also apply to 6.1+)
Access levelAdministrator or Super User login for the backend
Files to uploadImages, PDFs, or other media you plan to add to your site
Optional toolsAn 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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” HERO] Full-screen screenshot of the Joomla 6 Media Manager main screen: left folder tree, grid view of thumbnails in the main area, upload toolbar visible at top.
Alt text gợi ý: "Joomla 6 Media Manager main screen showing folder tree and file thumbnails in grid view"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 1] Joomla 6 admin sidebar with Content menu expanded, "Media" item highlighted/circled in red.
Alt text gợi Γ½: "Joomla 6 admin menu with Content β†’ Media option highlighted"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 3] Drag-and-drop upload in progress: cursor dragging an image file into the Media Manager window, progress bar visible.
Alt text gợi ý: "Drag and drop file upload in progress inside Joomla 6 Media Manager"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 4] New Folder dialog open with a folder name typed in (e.g. "blog-images") and the Create button visible.
Alt text gợi ý: "Creating a new folder in Joomla 6 Media Manager with the New Folder dialog"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 6] In-browser image editor open on a photo, with crop/rotate/resize toolbar visible above or beside the image.
Alt text gợi ý: "Joomla 6 built-in image editor showing crop, resize, and rotate tools"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 7] Article editor with the Insert Media dialog open, an image selected, and the alt text / alignment fields visible.
Alt text gợi ý: "Inserting an image into a Joomla 6 article using the Insert Media dialog"

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.

πŸ–ΌοΈ [αΊ’NH CαΊ¦N CHỀP β€” BƯỚC 8] Global Configuration β†’ Media β†’ Permissions tab, showing a user group row (e.g. Author) with the Upload permission set to Allowed and Delete set to Denied.
Alt text gợi ý: "Joomla 6 Media permissions tab restricting Author group to upload-only access"

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, not IMG_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.

βœ… Last verified on Joomla 6.1 β€” August 2026
Thanh Le
Thanh Le
Joomla Specialist & Technical Writer

Thanh Le is a Joomla expert and technical writer at Jlvextension.com, known for creating in-depth tutorials, extension reviews, and optimization guides. His work focuses on helping developers and webs