Getting Started with WordPress Media Library and File Upload Basics

Learn how to safely upload, organize, and manage images and files in the WordPress Media Library so your new site stays fast, tidy, and easy to maintain.

Why the WordPress Media Library Matters

Your Media Library is where WordPress stores all images, documents, and other files used across your site. Learning a few basics early will keep your website fast, organized, and easier to update later.

This guide is written for non-technical site owners using a modern version of WordPress. You do not need coding skills—just access to your WordPress dashboard.

Understanding What You Can Upload

By default, WordPress supports common file types for images, documents, audio, and video. Core-supported formats include JPEG, PNG, GIF, WebP, PDF, and a few others.Source

Safe, Common Image Types

• JPG / JPEG – best for photos and complex images.
• PNG – best for images needing transparency or sharp edges (logos, icons).
• GIF – simple animations; use sparingly for performance.
• WebP – modern format with smaller file sizes and good quality.Source

Documents and Other Files

• PDF – brochures, forms, and downloadable guides.
• DOC / DOCX and PPT / PPTX – sometimes allowed, but PDFs are usually safer and more consistent.
• MP3 / MP4 – audio and video files (though embedding from YouTube/Vimeo is usually better for performance).

File Types to Avoid

For security, avoid uploading executable files (like .exe, .js, or .php). WordPress blocks most of these by default to reduce risk.Source

How to Open and Understand the Media Library Screen

To access your Media Library:

1. Log in to your WordPress dashboard.
2. In the left-hand menu, click Media ? Library.

What You Should See

• A grid or list of existing media items (images, PDFs, etc.).
• View toggles: Grid View and List View.
• Filters for All media items, Images, Unattached, and date ranges.
• An Add New button near the top.

Uploading New Files Safely

You can upload files directly into the Media Library or while editing a page or post. The process is similar in both places.

Method 1: Upload from the Media Library

1. Go to Dashboard ? Media ? Library.
2. Click the Add New button at the top.
3. Either drag and drop files into the upload area, or click Select Files to choose files from your computer.
4. Wait for the progress bar to finish. When complete, thumbnails will appear in the library.

Method 2: Upload While Editing Content

1. Open a page or post via Dashboard ? Pages or Posts.
2. In the block editor, add an Image block (or Gallery, File, etc.).
3. Click Upload to add a new file from your computer, or Media Library to choose an existing file.
4. Once uploaded, the image or file will appear directly in your content.

What You Should See

• A progress indicator during upload.
• For images, a thumbnail preview once the upload completes.
• For documents, a file icon and filename.
• Any error messages if the file is too large or of an unsupported type.

Managing File Size and Performance

Large images can slow down your website. Before uploading, it’s best to resize and compress images so they’re appropriately sized for the web.Source

Simple File Size Guidelines

• Aim for most images to be under 300–400 KB when possible.
• Hero or full-width banner images might be larger, but try to keep them under 1 MB.
• Use tools like built-in image editors, online compressors, or design software export settings set to “web” or “optimized”.

WordPress Image Sizes

When you upload an image, WordPress automatically creates several resized versions (thumbnail, medium, large) based on your settings.Source

When inserting an image into content, choose the size that matches the layout instead of always using “Full Size.” This keeps pages lighter and faster.

Editing Media Details (Alt Text, Titles, and More)

Each media item has details that help with accessibility, SEO, and organization.

How to Edit Media Details

1. Go to Dashboard ? Media ? Library.
2. Click on an image or file to open its Attachment Details panel.
3. On the right side, you’ll see fields such as:

• Title – internal label; can help you search later.
• Alt Text – short description of the image for screen readers and when images fail to load.
• Caption – optional text that can appear below the image in posts.
• Description – longer internal notes; rarely shown on the front end.

Alt Text Basics

Alt text should briefly describe the content or purpose of the image, not just repeat keywords. For example:

• Weak: “Law firm”
• Stronger: “Two attorneys meeting with a client in a conference room”

Good alt text improves accessibility for visitors using screen readers and can support SEO when used naturally.Source

Organizing and Finding Files

WordPress stores files by upload date in the background, but you can still keep things organized with naming and filters.

Naming Files Before Upload

• Use clear, descriptive filenames, such as team-photo-2026.jpg instead of IMG_1234.jpg.
• Use hyphens instead of spaces.
• Avoid special characters like #, &, or ?.

Using Filters and Search

• Use the Search box in the Media Library to find files by title or filename.
• Filter by Images, Documents, or date ranges to narrow results.
• Switch to List View to see more details (dimensions, upload date, attached content).

Using Media with Elementor (If Your Site Uses It)

If your site is built with Elementor, you’ll still use the same Media Library, just accessed through Elementor widgets.

Adding Images in Elementor

1. From the dashboard, go to Pages and click Edit with Elementor on the page you want to edit.
2. Drag an Image widget into your layout.
3. Click the image placeholder, then choose Media Library or Upload Files.
4. Select or upload your image, then click Insert Media.

What You Should See

• The same Media Library interface you see in the main dashboard.
• Image size, alignment, and style controls in the Elementor sidebar.
• Your chosen image appearing immediately in the live preview.

Cleaning Up and Replacing Media Safely

Over time, your Media Library can become cluttered. It’s good practice to remove truly unused files, but do so carefully.

Before Deleting a File

• Check whether the file is used on any pages or posts.
• In List View, look at the Uploaded to column to see where it’s attached.
• If you’re unsure, consider leaving it or asking your web team before deleting.

Replacing an Image in Content

1. Edit the page or post where the image appears.
2. Click the image block (or Elementor widget).
3. Choose a new image from the Media Library or upload a new one.
4. Update the page to save your changes.

Note: Replacing an image in one place does not automatically change it everywhere else it’s used, unless your site uses a special global widget or pattern.

Simple Ongoing Habits for a Healthy Media Library

• Resize and compress images before upload.
• Use descriptive filenames and alt text.
• Periodically review and remove clearly unused test images.
• Avoid uploading unnecessary file types or very large videos directly to your site.

With these basics in place, you’ll be able to confidently upload, manage, and use media across your WordPress site without slowing things down or creating chaos behind the scenes.