Curated resource guide
WordPress Media Engineering Resources
Manage WordPress media as a system involving storage, metadata, formats, delivery, performance, accessibility, and security. This guide covers responsive images, WebP and AVIF, custom sizes, compression, SVG risk, embeds, lazy loading, CDN and object storage, large libraries, cleanup, migrations, REST handling, and private assets.
Scope
What this guide covers
- WordPress media library architecture
- attachment metadata
- image sizes
- responsive images and srcset
- image formats such as WebP/AVIF where supported
- image editing
- thumbnails
- regeneration
- EXIF
- upload validation
- SVG security considerations
- audio/video
- embeds
- lazy loading
- fetchpriority
- CDN/offload
- object storage
- signed/private media
- large libraries
- duplicate media
- cleanup
- search
- custom image sizes
- cropping
- compression
- performance
- accessibility
- REST API media handling
- and media migrations
Selected references
Curated resources
Links open the original publisher so you can use the complete, current material in context.
- 01Recommended starting point
Responsive Images
Understand WordPress image sizes, srcset, sizes, and responsive markup customization.
developer.wordpress.org - 02
REST API Media Endpoint
Create, retrieve, update, and delete attachment records through the supported REST endpoint.
developer.wordpress.org - 03
wp_get_attachment_image() Reference
Render attachment images with generated responsive attributes and controlled sizes.
developer.wordpress.org - 04
add_image_size() Reference
Register purposeful image variants while accounting for crop behavior and storage cost.
developer.wordpress.org - 05
wp_handle_upload() Reference
Use the WordPress upload pipeline instead of moving untrusted files manually.
developer.wordpress.org - 06
Web Image Performance
Improve image format, compression, sizing, loading, priority, and delivery using browser-focused guidance.
web.dev - 07
Media Library Screen
The official user-facing reference for attachment management, metadata, editing, and deletion behavior.
wordpress.org - 08
wp_generate_attachment_metadata() Reference
Understand how WordPress creates attachment metadata and image derivatives after upload.
developer.wordpress.org - 09
wp_get_image_editor() Reference
Use the supported abstraction for resizing, cropping, rotating, converting, and saving images.
developer.wordpress.org - 10
wp_calculate_image_srcset() Reference
Inspect how attachment metadata becomes responsive image candidates for a rendered size.
developer.wordpress.org - 11
MDN Image File Types
Compare browser support, compression behavior, transparency, animation, and use cases across image formats.
developer.mozilla.org - 12
OWASP File Upload Security
Harden media ingestion with layered type, name, size, storage, authorization, and serving controls.
cheatsheetseries.owasp.org