Blogging & content · Explainer
What Is Media Library in WordPress? Explained

Short answer
The Media Library is the part of the WordPress dashboard where every uploaded image, video, audio file and document is stored and managed. You open it under Media, then Library, or from any media block in the editor. Files live in the uploads folder, while their details sit in the database.
Key takeaways
- The Media Library is under Media, then Library in the dashboard.
- Files live in wp-content/uploads, details live in the database.
- WordPress creates several resized copies of each image.
- Core WordPress has no folders, only type and date filters.
- Backups must include the uploads folder, not just the database.
What is the Media Library in WordPress?
The Media Library is the central place in WordPress where every image, video, audio file and document you upload is stored, listed and managed, found in the dashboard under Media, then Library.
Whenever you add an image to a post, set a featured image or upload a PDF, the file lands in the Media Library. You can reuse it anywhere on the site without uploading it again.
Think of it as the site's file cabinet. Posts and pages hold the words, and the Media Library holds the files those words point to.
Where do you find the Media Library?
Log in to your dashboard and click Media, then Library in the left menu, or open it from the editor whenever you insert an image, video or file block.
The Media Library screen documentation on WordPress.org describes every part of this screen.
You will see it in two places:
- The Media screen in the dashboard, for browsing and managing all files.
- The media modal that pops up inside the block editor when you choose Media Library in an Image, Gallery, Cover or File block.
Both show the same files. The modal is just a smaller window for picking a file while you write.
What kinds of files can it hold?
It holds images, video, audio and documents such as PDF and Office files, limited to file types WordPress allows by default and to your server's upload size limit.
Common allowed types include JPEG, PNG, GIF, WebP, AVIF on newer versions, MP4, MP3 and PDF. WordPress keeps its own list of permitted file extensions for security reasons.
Some types, such as SVG, are blocked by default because they can contain code. Plugins can add support, but only do so if you trust the files.
Here is a quick summary:
| File type | Examples | Typical use |
|---|---|---|
| Images | JPEG, PNG, WebP, GIF | Post images, featured images, logos |
| Video | MP4, MOV, WebM | Embedded clips and backgrounds |
| Audio | MP3, M4A, WAV | Podcasts and music samples |
| Documents | PDF, DOCX, XLSX, PPTX | Downloads, menus, price lists |
Large videos are often better hosted on a video platform and embedded, since they use a lot of storage and bandwidth.
How does the Media Library store files?
Files are saved on your server in the wp-content/uploads folder, usually sorted into year and month subfolders, while details such as title and alt text are stored in the database as attachment posts.
Each upload creates an attachment record in the database. That record holds the title, caption, alt text, description and the file path.
The actual file sits in the uploads folder. By default WordPress uses folders like /uploads/2026/11/. You can turn this off under Settings, then Media.
Because the file and the record are separate, deleting a file through FTP leaves a broken entry in the library. Always delete media from inside WordPress.
What happens to images when you upload them?
WordPress keeps the original and creates several resized copies, such as thumbnail, medium and large, so themes can serve a suitable size on each page.
You can see the default sizes under Settings, then Media. Themes and plugins often register extra sizes too.
Since WordPress 5.3, very large images are scaled down to a maximum of 2560 pixels on the longest side, and the scaled copy gets -scaled added to its file name while the original is kept. The Make WordPress Core post on big image handling explains how this works.
These extra copies are why one upload can produce several files on the server. To keep things lean, read our guide on how to properly size images in WordPress.
What can you do inside the Media Library?
You can upload, search, filter, edit details, crop or rotate images, copy file URLs, and delete files, either one by one or in bulk.
The main tasks are:
- Upload by dragging files onto the screen or clicking Add New Media File.
- Filter by type, such as images or audio, and by month.
- Search by file name or title.
- Edit details like title, caption, alt text and description.
- Edit images with basic crop, rotate, flip and scale tools.
- Copy URL to link to a file directly.
- Bulk select to delete many files at once.
There are two views. Grid view shows thumbnails, and list view shows a table with author, attached post and date. Switch between them with the icons at the top.
Why does alt text in the Media Library matter?
Alt text describes an image for screen reader users and search engines, and adding it in the Media Library means it is filled in automatically whenever you insert that image.
The W3C alt text decision tree is a helpful guide to writing good descriptions. Decorative images can have empty alt text.
Alt text set in the library acts as a default. You can still change it for a specific use inside a block.
For image SEO tips, see our guide on how to optimize images for SEO in WordPress.
What does “uploaded to” or “attached” mean?
An attached file is linked to the post where it was first uploaded, and the Media Library shows that post in the Uploaded to column, though you can still use the file anywhere.
Attachment only records the original parent post. It does not stop you using the image on other pages.
Files uploaded directly through the Media screen are unattached. That is normal and does not cause any problem.
Does the Media Library have folders?
No, core WordPress shows all media in one flat list and only lets you filter by type and month, so folder views require a plugin.
Many site owners with thousands of files add a media folder plugin. These plugins add virtual folders in the dashboard without moving the actual files on the server.
If you have a smaller library, good file names and the search box are usually enough.
How big can a Media Library get?
There is no fixed WordPress limit on the number of files, so the practical limits are your hosting disk space, the upload size limit and how fast the library screen loads.
Each upload is capped by your server's maximum upload size, which you will see on the upload screen. Our guide on how to increase the max upload size shows how to raise it.
Very large libraries can make the media screen slow. Image optimization and removing unused files help. If the screen will not load at all, read our fix for the Media Library not loading.
Is the Media Library backed up?
The uploads folder is not part of the database, so a backup must include both the database and wp-content/uploads to restore your media fully.
Some backup tools only copy the database by default. Check that your plan includes files.
Losing the uploads folder leaves every image on the site broken, even though the library still lists them. See our guide on how to restore a WordPress site from backup for what a full restore involves.
How is the Media Library different from a CDN or image host?
The Media Library is where WordPress manages your files, while a CDN or external image service only delivers copies faster or stores them elsewhere.
Even when you use a CDN, the files still appear and are managed in the Media Library. The CDN swaps in its own address when pages load.
Some offload plugins move files to cloud storage such as Amazon S3. The library still shows them, but the files live off your server.
For most sites, the built-in library plus image optimization is all you need. You can learn more in the Learn WordPress lesson on the Media Library.
Frequently asked questions
Can other users see my Media Library?
Logged-in users with upload rights, such as Authors, Editors and Administrators, can open the Media Library. What each role can edit or delete depends on its capabilities, and Authors can usually only change their own files. Visitors cannot browse the library, though anyone with a file's direct URL can open it.
Does deleting an image from the Media Library remove it from posts?
Deleting removes the file and its resized copies from the server, so any post using it will show a broken image. WordPress does not automatically remove the image block from posts. Check where a file is used before deleting it.
Why are there so many copies of one image on my server?
WordPress creates resized versions for thumbnail, medium, large and any sizes your theme or plugins register. This lets pages load a smaller file where a big one is not needed. You can limit extra sizes, but removing them may affect how your theme displays images.
Can I rename a file in the Media Library?
Core WordPress lets you change the title, but not the actual file name or URL. To rename the file itself, use a plugin built for that purpose, or rename it before uploading. Renaming after publishing can break links if redirects are not handled.
Is there a storage limit for the Media Library?
WordPress itself sets no limit on the number of files. The limits come from your hosting disk space and the maximum upload size per file. WordPress.com plans and some managed hosts set their own storage caps, so check your plan details.
Sources
- Media Library Screen WordPress.org Documentation
- Using the Media Library Learn WordPress
- Introducing handling of big images in WordPress 5.3 Make WordPress Core
- An alt Decision Tree W3C Web Accessibility Initiative
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


