Media

Learn how WordPress stores, describes, transforms and displays images, audio, video, documents and other uploaded files.

Media is part of the content architecture of almost every WordPress website. A single uploaded image can create an attachment record, several generated image files, metadata, public URLs and references from posts, blocks, templates or plugins. Audio, video and documents introduce their own delivery, accessibility, storage and licensing decisions.

This section explains that complete system. It begins with the Media Library and ordinary upload workflows, then moves through image formats, sizes, responsive delivery, descriptive fields, editing, embeds, attachment pages, metadata, organization, optimization, external storage, migration and long-term maintenance.

What WordPress Means by Media

In WordPress, media is not limited to visual decoration. The Media Library can contain images, audio, video and many document formats. Each uploaded item is normally represented by an attachment post in the database and a file in the uploads directory or an external storage system.

The attachment record can contain a title, caption, description, alternative text, MIME type, parent relationship and technical metadata. Images may also generate multiple sub-sizes for different layouts and devices.

Understanding the difference between the attachment record and the physical file is essential when replacing, migrating, deleting or optimizing media.

What You Will Learn

Media Library and Uploads

Learn how to upload, filter, edit, attach, reuse and delete media without creating unnecessary duplicates or broken references.

Image Formats and Sizes

Compare JPEG, PNG, GIF, SVG, WebP and AVIF, then understand thumbnails, registered image sizes, cropping and the files generated during upload.

Responsive and Accessible Media

Understand srcset, sizes, alternative text, captions and the difference between descriptive metadata and visual presentation.

Audio, Video, Documents and Embeds

Choose between self-hosted files and external platforms, configure media blocks and provide accessible alternatives such as captions, transcripts and meaningful link text.

Metadata and Attachment Pages

Learn how WordPress stores media as attachments, reads image metadata and may expose dedicated attachment URLs depending on the theme and site configuration.

Organization and Optimization

Build naming, ownership, compression, delivery and retention practices that remain manageable as the library grows.

Storage, Migration and Maintenance

Plan CDN integration, object storage, URL rewriting, media replacement, migrations, unused-file audits and troubleshooting.

Who This Section Is For

This section is useful for:

• Editors and content teams managing a shared library.
• Designers preparing images for responsive layouts.
• Administrators responsible for storage and performance.
• Developers integrating uploads, attachments or external storage.
• SEO and accessibility specialists reviewing media content.
• Agencies migrating or maintaining client websites.

The first documents are suitable for beginners. Articles about metadata, CDNs, migration and troubleshooting include more technical detail.

Media Is Shared Infrastructure

A media decision can affect several systems at once. An oversized image influences performance. Missing alternative text affects accessibility. A changed file URL can break content, feeds or external links. A deleted attachment may remove a file used by several pages. An external video can introduce privacy, availability and consent considerations.

For that reason, media should be managed as shared website infrastructure rather than as disposable files attached to individual pages.

Recommended Reading Order

Start with the Media Library and upload workflow. Continue through image formats, sizes and responsive images before working on optimization or external delivery. Read attachment pages and media metadata before performing bulk replacement, migration or cleanup.

The final documents focus on licensing, unused media and troubleshooting. They are especially useful when establishing a maintenance policy for an existing site.

Begin with the WordPress Media Library

The first article explains what the Media Library contains, how attachment records relate to files and what WordPress means when an item is attached or unattached.

Continue to Understanding the WordPress Media Library