How to Add Images on WordPress: The 2026 Step-by-Step Guide

Learning how to add images on WordPress takes about ten seconds: open a post, click the plus button, choose the Image block, then upload or select a file. The part most tutorials skip is everything that happens after the upload, like file size, alt text, and why your page suddenly loads two seconds slower. This guide covers both halves, from the first click to the compression settings we recommend to hosting customers every week.

The fastest way to add an image to a post or page

The block editor (Gutenberg) has been the default WordPress editor since version 5.0, and the Image block is the tool you’ll use for roughly 90% of image work. The steps are identical for posts and pages.

1. Open the post or page you want to edit, and place your cursor where the image should sit.
2. Click the black + button (top left of the editor, or the inline plus between blocks).
3. Search for Image and select the block.
4. Choose Upload for a new file, Media Library for something you’ve already added, or Insert from URL for a hosted file.
5. Fill in the alt text in the right-hand sidebar, set alignment and size, then update the post.

If you type /image on an empty line and press Enter, WordPress inserts the block instantly. That slash shortcut works for galleries, cover blocks and video too, and it saves a surprising amount of time once it becomes muscle memory.

Three ways to get files into the Media Library

The Media Library is the central store for every image, PDF and video on your site. You can reach it from Media > Library in the dashboard, or from inside any block that accepts media.

• Drag and drop: drag files from your desktop straight onto the editor or the library screen. This is the quickest route for batches of 5 to 20 photos.
• Upload Files tab: click Media > Add New, then Select Files and browse. Useful when your files live in nested folders.
• Insert from URL: paste a direct link to an image hosted elsewhere. It works, but the file stays on someone else’s server, so if that link breaks your image disappears.

Uploading to your own library is almost always the better call. It keeps the file in your backups, lets WordPress generate responsive sizes, and gives you control over the alt text. The same logic applies when you need to upload and embed a PDF in WordPress.

Featured images work differently

A featured image isn’t inserted into the body content. It sits in the post settings sidebar under Featured image > Set featured image, and your theme decides where it appears: archive thumbnails, the top of the single post, social share previews.

Most themes want a featured image around 1200 x 630 pixels, which also matches the Open Graph ratio that Facebook and LinkedIn prefer. If your featured images look cropped in odd places, that ratio mismatch is usually the culprit.

Adding multiple images at once

For several photos in one spot, skip stacking individual Image blocks. WordPress has purpose-built options that handle spacing and mobile layout for you.

• Gallery block: select many files in one upload, then set 2 to 6 columns. Best for portfolios and event recaps.
• Columns block: gives you side-by-side images with independent captions and links.
• Cover block: a full-width background image with text layered on top, handy for section headers.
• Media & Text block: one image beside a paragraph, which stacks cleanly on phones.

Photographers and publishers pushing dozens of high-resolution files per post feel the storage and bandwidth cost fast, which is why we built specific plans for image-heavy magazine and publishing sites.

We cover this topic in more depth in What Is the Difference Between WordPress and WooCommerce? A 2026 Explainer.

For a closer look at this topic, see our guide: How to Add Live Chat to a WordPress Website (2026 Guide).

How to add an image in Elementor and other builders

If you use Elementor, drag the Image widget onto the canvas, click the placeholder thumbnail, and pick or upload a file. The Style tab controls borders, hover effects and CSS filters, while the Advanced tab handles margins.

Divi, Beaver Builder and Bricks follow the same pattern: a media widget, a library picker, then styling controls. Whatever builder you use, the file still lands in the standard WordPress Media Library, so the optimization rules below apply equally.

Prepare the image before you upload it

This is where the top-ranking tutorials go quiet, and it’s the difference between a fast page and a sluggish one. Images account for a large share of total page weight on the average site, according to the HTTP Archive Web Almanac page weight report.

• Resize first: most content areas are 700 to 900 pixels wide, so export at 1200 to 1600 pixels for retina screens. A 4000-pixel camera file is pure waste.
• Pick the right format: WebP for photos and most graphics, PNG for anything needing transparency, SVG for logos and icons. WordPress core has accepted WebP uploads since 5.8 and AVIF since 6.5.
• Target under 200 KB per in-content image, and under 400 KB for full-width hero shots.
• Name the file descriptively: copper-farmhouse-sink.webp beats IMG_4471.jpg for image search.

On our platform, LiteSpeed Cache handles conversion and compression automatically, and the global CDN serves the result from an edge location near the visitor. That combination usually cuts image transfer weight by 30% to 60% without any plugin fiddling.

Alt text, captions and accessibility

Alt text describes the image for screen reader users and for search engines that can’t see it. Write what the image actually shows in 8 to 15 words, and skip filler like “photo of” since assistive tech already announces it as an image.

Purely decorative images should have an empty alt attribute so screen readers skip them, a rule laid out in the W3C Web Accessibility Initiative image tutorial. Captions, by contrast, are visible to everyone and work well for credits, sources or context.

Alt text also feeds Google Images, so it pairs naturally with the rest of your on-page work. If you’re tightening structure at the same time, our guides on adding internal links in WordPress and changing SEO settings in WordPress cover the neighbouring pieces.

When the upload fails: common fixes

Image upload errors trace back to four causes in nearly every support ticket we handle.

• “Exceeds the maximum upload size”: your PHP upload_max_filesize is too low. Hosts commonly default to 2 MB to 64 MB; ask support to raise it, or shrink the file.
• HTTP error on upload: usually a PHP memory limit below 256 MB, or an ImageMagick conflict. Retry after a minute, then raise memory.
• “Unable to create directory”: incorrect permissions on /wp-content/uploads, which should be 755 for folders and 644 for files.
• Unsupported file type: WordPress blocks SVG by default for security reasons, so use a vetted plugin or convert to PNG.

Persistent failures are worth escalating rather than guessing at. Our WordPress support team answers in under two minutes, and PHP limits are a five-minute fix on our end.

Frequently Asked Questions

How do I import images into WordPress?

Go to Media > Add New and drag your files in, which handles up to 20 or so images per batch comfortably. For bulk imports from another platform, plugins like Import External Images or the built-in WordPress importer pull remote files into your library and rewrite the URLs automatically.

Why can’t I add an image to WordPress?

In most cases it’s a PHP limit: an upload cap under 8 MB or a memory limit under 256 MB blocks the file before it saves. Other frequent causes are wrong folder permissions on /wp-content/uploads, a plugin conflict, or an unsupported format such as SVG or HEIC.

How do I embed an image in a website?

Any image on a web page is embedded with an HTML <img> tag containing a src URL and an alt description. WordPress writes that tag for you when you use the Image block, and it adds responsive srcset sizes plus loading="lazy" on below-the-fold images by default.

How do I add multiple images in a WordPress post?

Use the Gallery block and select every file in a single upload, then choose between 2 and 6 columns. If you’d rather control each image separately, the Columns block or several stacked Image blocks give you individual captions, links and alignment settings.

Want images that load fast, not just correctly?

Adding an image is easy; serving it in under a second to a visitor on mobile data is a hosting problem. See what our WordPress blog hosting and membership hosting plans include, or start a 14-day trial and migrate your existing site free.