MODULE 01 · FOUNDATIONS

Working with the Media Library

Every image, video, and file on your site funnels through one place. Today you'll learn to manage it properly — before it becomes a mess.

Day 10 of 30 Beginner ~20 min

One Library, Every File

Whenever you upload an image inside the block editor, it doesn't just attach to that one Post or Page — it gets added to your site-wide Media Library, reusable anywhere else on the site.

This matters more than it sounds: a logo you upload once can be reused on ten different pages without uploading it again.

The Details Behind Every Upload

Every image you upload has a handful of fields that are easy to skip — but shouldn't be.

FIELD WHAT IT'S FOR
Alt Text

A written description read by screen readers and search engines — not visible to sighted visitors.

Caption

Text displayed underneath the image on the page itself, if your theme shows it.

Title

Internal label shown in the Media Library — rarely visible to visitors.

File size

Directly affects how fast your page loads — large images are the #1 cause of slow sites.

DON'T SKIP THIS

Alt Text isn't optional polish — it's how screen-reader users understand your images, and how search engines index them. Get in the habit of filling it in every time.

Behind an Image Upload

A single upload does more work behind the scenes than it looks like from the editor.

upload-flow.txt
// What happens when you upload an image
1. Store original file   // full-resolution version, saved as uploaded
2. Generate thumbnail     // small, square-cropped preview size
3. Generate medium size   // used in content by default
4. Generate large size    // used for featured images, full-width blocks
5. Add to Media Library   // reusable on any Post or Page from now on

Step-by-Step: A Clean Upload

Follow this each time — it takes seconds and saves cleanup work later.

  • Resize before uploading — aim for under 500KB where possible; huge camera photos slow every page they're on.
  • Use a descriptive filename — "blue-ceramic-mug.jpg" beats "IMG_4821.jpg" for search visibility.
  • Add an Image block and upload — drag the file in, or click "Upload" in the block's placeholder.
  • Fill in Alt Text immediately — in the block settings panel on the right.
  • Choose the right size — the block's size dropdown controls which generated version actually loads.
  • Two Different Jobs

    These often get confused because both are "just a picture attached to a Post" — but they behave very differently.

    FEATURED IMAGE Set once per Post/Page in the sidebar panel — used in previews, social shares, and archive listings.
    IN-CONTENT IMAGE Placed directly inside the body via an Image block — appears exactly where you drop it.

    Keeping Your Library Clean

    STATUS CHECK
    ALT TEXT Every image used in content has a written Alt Text field filled in.
    FILE SIZE No single image over roughly 1MB — large files slow down every page they appear on.
    UNUSED FILES Media Library → filter by "Unattached" to spot uploads that aren't used anywhere.

    Breaking Down What You Just Learned

    1

    The Media LibraryA single, site-wide store of every file you've uploaded, reusable anywhere.

    2

    Alt TextA written description for accessibility and search visibility — not the same as a caption.

    3

    Generated sizesWordPress automatically creates thumbnail, medium, and large versions of every upload.

    4

    Featured ImageA single representative image per Post/Page, used in previews and listings.

    5

    File sizeDirectly affects page load speed — resize before uploading, not after.

    Try It Yourself

    EXERCISE

    Go to Media → Library, click on any image you've uploaded, and check whether its Alt Text field is filled in. If it's blank, add a short, accurate description now.

    Set Up a Clean Media Library

    HANDS-ON EXERCISE

    Upload, describe, and assign images correctly

    A tidy Media Library from the start saves real time later in the course.

    1. Upload two or three images with clear, descriptive filenames.
    2. Fill in Alt Text for each one immediately after uploading.
    3. Set a Featured Image on the Post you created in Day 4.
    4. Insert one of the images directly into the body using an Image block.
    5. Open Media → Library and filter by "Unattached" to confirm nothing was left orphaned.

    Recap

    MEDIA LIBRARY

    One site-wide store for every uploaded file, reusable anywhere.

    ALT TEXT

    Written description for accessibility and search — fill it in every time.

    FEATURED IMAGE

    One representative image per Post/Page, shown in previews and listings.

    FILE SIZE

    Resize before uploading — the biggest lever for page speed.

    Key Takeaways

    • Every upload lands in a single, site-wide Media Library, reusable anywhere.
    • Alt Text supports accessibility and search — always fill it in.
    • WordPress automatically generates thumbnail, medium, and large versions of each image.
    • Featured Images and in-content images serve different, distinct purposes.
    • Resize images before uploading to keep pages fast.
    Course Overview