WordPress Media Library: Managing Images and Files
Learn how to upload, organize, and optimize images, videos, and documents in WordPress.
The WordPress media library is where all your images, videos, and documents are stored. Good media management keeps your site fast and organized. In this guide, we explain everything.
Opening the Media Library
Via the Menu
- Click on Media in the left menu
- You'll now see all your uploaded files
From the Editor
- Click on an image block
- Choose Media Library
- You can also upload directly here
Uploading Files
Method 1: Via the Media Menu
- Go to Media > Add New
- Drag files to the upload area
- Or click Select Files to browse
- Wait for the upload to complete
Method 2: From the Editor
- Click on the + icon
- Choose Image, Video, or File
- Click Upload
- Select your file
Method 3: Drag from Your Computer
- Open the media library
- Drag a file directly from a folder on your computer
- The file uploads automatically
Supported File Types
Images
- JPG/JPEG
- PNG
- GIF
- WebP (from WordPress 5.8)
- SVG (with plugin)
- ICO
Video
- MP4
- MOV
- WMV
- AVI
- MPG
Audio
- MP3
- WAV
- OGG
Documents
- DOC/DOCX
- XLS/XLSX
- PPT/PPTX
- TXT
Organizing Files
Search
- Use the search bar at the top right
- Search by filename or title
Filter
- Click on All media items
- Filter by:
- Type (images, video, audio, etc.)
- Date (month/year)
- Uploaded by (if you have multiple users)
Adjust View
- Grid view: Thumbnail overview (default)
- List view: Detailed list with more info
Toggle via the icons at the top left.
Create Folders (with plugin)
WordPress doesn't have folders by default. With plugins it does:
Recommended plugins:
- FileBird
- Real Media Library
- MediaPress Folders
After installation:
- Create folders in the sidebar
- Drag media to folders
- Filter by folder
Editing Files
Adjust File Details
- Click on a file in the media library
- On the right side you'll see:
Title: The name of the file (visible in admin).
Caption: Text that can be displayed below the image.
Alt text: Description for accessibility and SEO. Always fill this in!
Description: Longer description (rarely used).
File URL: Direct link to the file.
Edit Image
WordPress has basic image editing features:
- Click on an image
- Click Edit Image below the preview
Available options:
Crop:
- Drag to make a selection
- Click the crop icon
- Or enter exact ratios (16:9, 4:3, etc.)
Rotate:
- 90 degrees left
- 90 degrees right
Flip:
- Horizontal
- Vertical
Scale:
- Click "Scale Image"
- Enter new dimensions
- Proportions are maintained
Important: Edits are applied to:
- All sizes
- Thumbnail only
- Everything except thumbnail
Save Changes
- Save: Overwrites the original
- Save as new: Creates a copy
Image Sizes
WordPress automatically creates multiple sizes of each upload:
Default Sizes
- Thumbnail: 150 x 150 pixels (cropped)
- Medium: Max 300 x 300 pixels
- Large: Max 1024 x 1024 pixels
- Full: Original size
Adjust Sizes
- Go to Settings > Media
- Adjust the pixel values
- New uploads will get these sizes
Note: Existing images won't be adjusted. Use the "Regenerate Thumbnails" plugin to update those.
Extra Sizes from Themes
Your theme may add extra sizes (e.g., for headers or portfolios). Check the theme documentation.
Optimizing Images
Large images make your site slow. Optimize for speed.
Before Uploading
Choose format:
- JPEG: Photos (good compression)
- PNG: Images with transparency
- WebP: Modern option (best compression)
- SVG: Icons and logos (infinitely scalable)
Adjust dimensions: Don't upload larger than needed. If your site displays max 1200px wide, don't upload 4000px images.
Compress: Use tools before upload:
- TinyPNG/TinyJPG (online)
- ImageOptim (Mac)
- Squoosh (online, Google)
After Uploading (with plugins)
Recommended plugins:
- ShortPixel
- Imagify
- Smush
These compress automatically on upload and can bulk-optimize existing images.
Replacing Files
With Plugin (recommended)
Enable Media Replace plugin:
- Install and activate the plugin
- Go to the media library
- Click on the file
- Click Upload a new file
- Choose:
- Replace the file (same name)
- Replace and update links
Manually
- Upload the new file
- Edit all pages/posts where the old file is used
- Replace the image blocks
- Delete the old file
This is time-consuming - better to use the plugin.
Deleting Files
Delete Single File
- Click on the file
- Click Delete Permanently at the bottom
- Confirm
Note: First check if the file is being used somewhere!
Bulk Delete
- Click Bulk Select at the top
- Select multiple files
- Click Delete Permanently
Find Unused Media
With Media Cleaner plugin:
- Scans your media library
- Finds files not used anywhere
- Delete safely in bulk
Always make a backup first!
Frequently Asked Questions
Increase maximum upload size? This depends on your hosting. Options:
- Ask your host to increase the limit
- Adjust php.ini (if you have access)
- Use "Big File Uploads" plugin
Can I customize the upload folder structure? Yes, via Settings > Media > "Organize my uploads into month- and year-based folders"
How do I find where an image is used? With the "Media Library Assistant" plugin, you can see which posts use an image.
Can I rename files? Not by default. Use the "Phoenix Media Rename" plugin.
Image not showing after upload? Check:
- File type is supported
- File is not corrupt
- No special characters in filename
Tips for Good Media Management
-
Name files descriptively before upload (team-photo-jan.jpg, not IMG_4532.jpg)
-
Always fill in alt text for accessibility and SEO
-
Optimize images for faster load times
-
Clean up regularly - delete unused files
-
Make backups before bulk-deleting
-
Use folders (with plugin) for large media libraries
Questions about WordPress? Feel free to contact us.
More WordPress Guides
- WordPress Menu Customization - Managing and optimizing navigation
- WordPress Duplicate Pages - Copy content quickly
Related
- Core Web Vitals Explained - Image optimization for speed
- Website Performance Optimization - Comprehensive performance guide
Robuust Marketing
Marketing & Development Team
Het team van Robuust Marketing helpt MKB-bedrijven met professionele websites, hosting en online marketing strategieën.
Related articles
WordPress Duplicate Page or Post: 3 Methods Explained
Want to copy a page or blog post in WordPress? Discover three ways to quickly duplicate content.
WordPressWordPress Menu Customization: Managing and Optimizing Navigation
Learn how to create, edit, and optimize menus in WordPress. From basic navigation to dropdown menus.
Need help with your website?
We're happy to help you with development, hosting and online marketing.
Contact us