How to Upload and Manage Images in WordPress

September 11, 2025
How to Upload and Manage Images in WordPress

Images make your WordPress site more engaging and visually appealing. WordPress includes a built-in media library that makes it easy to upload, organize, and manage images. Here’s a step-by-step guide for beginners.

Step 1: Access the Media Library

  • Log in to your WordPress dashboard.
  • In the left-hand menu, click Media → Library.
  • Here you can see all the images and media files you’ve uploaded.

Step 2: Upload Images

There are two main ways to upload images:

Option A: Upload via Media Library

  1. Go to Media → Add New.
  2. Click Select Files or drag and drop images into the upload area.
  3. The files will be added to your media library.

Option B: Upload While Editing a Post/Page

  1. Open the block editor for a post or page.
  2. Click the + icon and add an Image block.
  3. Upload a new file or select from the media library.

Step 3: Edit Image Details

After uploading, click on an image in the media library to edit its details:

  • Title: Internal name of the image.
  • Alt Text: Describes the image for screen readers and improves SEO.
  • Caption: Text displayed below the image (optional).
  • Description: Longer description (optional, not usually displayed).
  • File URL: Direct link to the image file.

Step 4: Insert Images into Content

  1. In the editor, add an Image block.
  2. Click Media Library and select the image you want to use.
  3. Adjust alignment, size, and link options in the block settings.

Step 5: Organize and Manage Images

  • Use the list/grid view in the media library to browse files.
  • Use the search box to find images by file name or title.
  • Filter images by type (e.g., images, audio, video) or date uploaded.
  • Click Edit Image to crop, rotate, or scale images directly inside WordPress.

Step 6: Best Practices for Image Management

  • Use descriptive file names: Helps with SEO (e.g., blue-mountain-sunset.jpg).
  • Always fill in alt text: Improves accessibility and search visibility.
  • Optimize image size: Large images can slow down your site. Use an image optimization plugin like Smush or ShortPixel.
  • Organize by folders (optional): Plugins like FileBird let you create folders inside the media library.

Summary

  1. Upload images through the media library or directly in posts/pages.
  2. Edit image details (title, alt text, caption) for SEO and accessibility.
  3. Insert images using the block editor’s image block.
  4. Manage and organize your library with filters, search, and plugins if needed.
  5. Optimize images for faster site speed and better performance.

With these steps, you’ll be able to upload and manage images effectively in WordPress, keeping your site organized and visually appealing.

Avatar

Written by

satoshi

I’ve been building and customizing WordPress themes for over 10 years. In my free time, you’ll probably find me enjoying a good football match.