Joomla’s Media Manager is simple by design, but how you use it has long-term consequences. Poor media habits lead to clutter, broken links, oversized backups, and confusion during redesigns. This tutorial covers the basics of using the Media Manager in a way that stays manageable over time.
Before You Start
- You should be able to create and edit articles.
- You should have access to the Joomla Administrator.
- No extensions are required.
What the Media Manager Is (and Is Not)
The Media Manager is Joomla’s built-in tool for managing media files used in content.
It Is Used For
- Uploading images and documents
- Organizing files into folders
- Selecting media inside the editor
It Is Not
- A digital asset management system
- An image editor
- A replacement for server-level file access
Understanding its scope helps set realistic expectations.
Step 1: Access the Media Manager
You can open the Media Manager from:
- Content → Media
- The editor’s media selection button
Both interfaces point to the same underlying file system.
Let me give you an example of structuring the media manager to be prepared for your website's media by using GeJay Media's own:
Step 2: Use a Clear Folder Structure
By default, Joomla stores media under an images folder (directory). How you organize folders inside it matters.
Recommended Folder Practices
- Group files by purpose, not by date (like WordPress does) alone
- Avoid dumping everything into one folder
- Use descriptive folder names
A predictable structure reduces duplication and confusion.
Step 3: Name Files Intentionally
File names matter more than many site owners expect.
Good File Naming Habits
- Use lowercase letters
- Avoid spaces and special characters
- Choose descriptive names
Renaming files later will break links inside the content.
Step 4: Upload Files Carefully
Media uploads are permanent once referenced.
Before Uploading
- Confirm the file is actually needed
- Check image dimensions and file size
- Avoid uploading near-duplicates
Media clutter accumulates quietly and is rarely cleaned up. One of the biggest side effects of out-of-control media can be seen when you do website backups. Your backup files become massive! This website is about tutorials and course materials for learning; media like images and videos are a big part. Careful planning and organization are paramount!
Step 5: Understand Media Options and Limits
Joomla includes configuration options for media handling.
Common Settings
- Allowed file types
- Upload size limits
- Image resizing (if enabled)
These settings are often inherited from the server configuration.
Step 6: Avoid Deleting Referenced Media
Deleting files directly affects published content that can generate broken images (404 not found).
Before Deleting
- Confirm the file is not used in any articles
- Search the content if necessary
- Consider archiving instead of deleting
Broken images degrade credibility quickly.
Media Manager and Editors
The editor integrates with the Media Manager.
Best Practices
- Insert media using the editor tools, not raw URLs
- Use relative URLs (paths) for everything
- Avoid hardcoding paths unless necessary
- Use captions and alt text consistently
This improves accessibility and maintainability.
Verify Your Results
- Media files are organized predictably.
- File names are clear and consistent.
- Unused uploads are minimized.
- Content does not rely on fragile file paths.
Common Issues
- Broken images: Files deleted or renamed after use, which end up as 404 errors (not found).
- Cluttered media folders: No upload discipline.
- Large backups: Oversized or duplicate media files.
Related Tutorials / Next Steps
- Next: Content Organization Best Practices
- Creating and Managing Articles in Joomla
- Using Categories Effectively
Media management rarely feels urgent, but it quietly shapes site health. Consistent habits prevent long-term mess, and Joomla gives you a powerful media management system.