Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

How to Fix Common Image Issues in WordPress (Ultimate Guide)

Managing images in WordPress isn’t always straightforward. Without the right tools or techniques, fixing image-related issues can be frustrating and time-consuming.

While images are key to making your WordPress site engaging and visually appealing, issues can still arise. We’ve heard from plenty of users who suspect that their images are affecting site loading times, display quality, or sizing.

These problems can negatively impact your site’s performance and user experience.

At WPBeginner, we’ve been using WordPress for over 16+ years, consistently uploading images to enhance our content and boost engagement. During this time, we’ve learned the best ways to handle these issues efficiently.

In this guide, we’ll show you how to fix common image issues in WordPress, helping you improve your site’s speed, appearance, and overall performance.

Fixing common image issues in WordPress

Since this is a detailed article, here is the list of image-related issues that we will cover in this article. You can use these quick links to skip to a certain topic:

Need help fixing WordPress image issues? At WPBeginner Pro Services, we offer affordable Emergency WordPress Support to resolve all of your WordPress image issues or other website problems – quickly and reliably. Stop stressing over your site and get it taken care of. Check out our Emergency WordPress Support Services today!

How to Upload Images in WordPress

WordPress makes it super easy to upload images to your posts, pages, and non-content areas like sidebars.

To upload images in WordPress posts and pages, you simply need to add the Image block to the content editor.

Adding an image block to your WordPress website

You can also add the Image block by simply typing /image into a ‘Paragraph’ block.

The editor will start showing blocks you can insert as soon as you start typing.

Adding image block

WordPress will now add the Image block to the editor.

You need to click on the ‘Upload’ button to select and upload the image from your computer.

Select and upload image

You can also select a previously uploaded image from your ‘Media Library.’

After uploading the image, you will see a live preview of the image in the content editor.

Image preview

You will also see image settings in the right panel. From there, you can provide image alt text, select the image size, and customize the image style.

Pro Tip: Are you experiencing issues with uploading images to WordPress? Check out our guide on how to fix the image upload issue in WordPress.

How to Align an Image to the Left or Right in WordPress

With WordPress, aligning images to the left, right, or center is easy.

Simply select the image by clicking on it, and then click on the alignment button from the block toolbar.

Image alignment options

You may have noticed how some popular WordPress blogs use images with text wrapped around them.

This is done by using the align feature.

Image aligned left with text on the right

Alternatively, you can also use the ‘Media & Text’ block instead of the ‘Image’ block.

This block is made specifically to add images next to the text.

Media and text block

You can then upload an image and text side by side.

You can also use the block toolbar to change the image or text side.

Image next to the text in WordPress

For detailed guidance, you can check out our guide on how to align images using the WordPress block editor.

How to Add Captions Below Images

WordPress allows you to easily add captions for images. After you upload an image, you will see the option to add a caption right below the image preview.

Write caption for an image in WordPress

Similarly, you can also add captions to image galleries in WordPress. For more details, please see our guide on how to add captions to images in WordPress.

How to Display Photos in Columns and Rows

Often, users ask us how to neatly display photos in columns and rows.

Let’s say you want to share photos of a birthday party or vacation photos. You can add them one by one into a post, but this will look like a lengthy list of images.

The better way to group your photos is by creating image galleries.

WordPress comes with a built-in ‘Gallery’ block that allows you to easily add images in rows and columns with thumbnail previews.

Simply add the ‘Gallery’ block to the post editor and select the images you want to upload.

Adding a gallery in WordPress

For more detailed instructions, you’ll want to see our guide on how to create an image gallery in WordPress.

How to Create Responsive Image Galleries in WordPress

You will notice that the default WordPress image galleries lack several features. For instance, they are also not very easy to browse.

If you often upload images and photographs to your WordPress site, then you will need a WordPress photo gallery plugin.

We recommend using Envira Gallery. It allows you to easily create beautiful and fully mobile-friendly image galleries on your WordPress site.

For more information about the plugin, you can check out our complete Envira Gallery review.

Envira Gallery

The best part is that it adds additional functionality like albums, gallery templates, social sharing, slideshows, watermarking, pagination, password protection, tagging, fullscreen view, and much more.

Another popular WordPress photo gallery plugin is NextGEN Gallery. It offers many gallery layouts and a beautiful lightbox gallery for displaying images in WordPress.

NextGen Gallery

NextGEN Gallery also includes powerful features for professional photographers like photo proofing, print fulfillment, image protection, Adobe Lightroom addon, PayPal and Stripe payment gateways, and more.

For more details, you might want to check out our complete NextGEN Gallery review.

How to Fix Missing Post Thumbnails / Featured Image

Most WordPress themes allow you to prominently display a featured image with your articles. Let’s look at how to set a featured image in WordPress to avoid missing thumbnails.

Setting a featured image for a WordPress post

First, you need to click on ‘Set Featured Image’ to upload your post thumbnail.

After uploading the image, you will be able to see your post thumbnail in the featured image meta box like this.

Featured image preview in post editor

For more details, see our guide on how to add a featured image or post thumbnail in WordPress.

How to Add Cover Images in WordPress Posts and Pages

Cover images are wide or full-width images that can be used as a separator between different sections of an article or a lengthy sales page.

They are highly engaging and help users easily scan a page without feeling overwhelmed by too much text.

To add a cover image, you simply need to add the Cover block to the content editor.

Add the Cover block

Next, you need to upload the image you want to use from your computer or select one from the Media Library. If you don’t want to use an image, then you can also select a color background as the cover.

Expert Tip: It is best to use a large image for a better result.

You will now see a live preview of your cover image in the editor. You can change the cover image display options from the block toolbar or use the settings on the right.

Cover image preview

To learn more, see our guide on the difference between cover image vs. featured image in WordPress and how to use them effectively.

How to Fix the Featured Image Appearing Twice Issue

Inserting the featured image inside content is a common mistake made by beginners.

Once you set a featured image, you don’t need to insert it into the post along with your content.

Doing so will make your featured image appear twice. Once as the featured image and once as an image inside the post.

Featured image appearing twice

You can add other images inside your post, but your featured image goes in the featured image box.

For more details, feel free to read our guide on how to fix featured images appearing twice in WordPress posts.

How to Crop Images in WordPress

When you are uploading images from your phone or camera, they are usually too big.

WordPress automatically creates small, medium, and large image sizes for your original upload. But sometimes, you may need to crop the image in a different size.

WordPress is no Photoshop, but it comes with some basic image editing features like scale, crop, flip, and rotate images.

Simply go to Media » Add New and upload your image. After uploading the image, you will see an ‘Edit’ link next to the uploaded image.

Clicking on it will open the ‘Edit Media’ screen, where you will see an ‘Edit Image’ button right below the image. This will open the WordPress image editor.

Editing image in WordPress

From here, you can click on the ‘Edit Image’ button below the image preview. This will open the image editing screen.

On the image editor screen, you will see buttons to perform some basic image editing tasks such as cropping, rotating, resizing, etc.

WordPress image editing features

If you use the block editor, you can crop images by using the built-in crop feature in the image toolbar.

Simply click on an image block and select the ‘Crop’ icon in the toolbar.

Clicking the Crop button in the Image Block Toolbar

After that, you can adjust the image’s aspect ratio and the cropped area of your image to your preference.

You can use your original aspect ratio or a predefined one by WordPress.

Selecting an aspect ratio in the Image Block Toolbar

For more detailed instructions, you can see our guide on how to crop, rotate, scale, and flip images in WordPress.

How to Add a Header Image in WordPress

A header image in WordPress is a theme feature. Many WordPress free and premium themes come with support for header images.

Some WordPress themes allow you to set a site-wide header image, while others allow you to only set a header image for the homepage.

You can upload your own custom header image from the Appearance » Customize page.

Header options

If you use a Block theme, the location to edit your theme’s header is different.

First, you need to go to Appearance » Editor.

Selecting the Full-Site Editor from the WordPress admin panel

Then, go ahead and select ‘Patterns.’

This will bring you to a page where you can access your theme’s header pattern.

Patterns in site editor

After that, you’ll want to scroll down to the ‘Template Parts’ section.

Once you’ve done that, just select ‘Header’ and click on the header template to edit it.

Selecting the Header pattern on the WordPress Block Editor

From there, you can add an image block to the header pattern like you would in the first section of this article.

How to Add a Background Image in WordPress

Like the custom header image, a custom background image is a WordPress theme feature. Many WordPress themes support custom background images.

Visit Appearance » Customize to launch the ‘Theme Customizer.’

If you can see the ‘Background Image’ option, then your theme has support for custom backgrounds.

Custom background

It is a theme feature, which is why it varies from one theme to another. Depending on your theme, you will see different options for styling your background image.

If your theme does not support a background image, then you can still use a plugin to add full-screen background images to your website.

How to Optimize Images for WordPress Without Losing Their Quality

One of the most common image issues WordPress users come across is how to compress their images without losing their quality. 

Besides being quicker to upload, optimized images load faster on the front, which enhances the user experience and reduces the bounce rate. This is because they consume less bandwidth, saving on data usage for users with limited internet connections. 

Search engines also consider page speed when ranking websites. Optimized images contribute to faster loading times, potentially boosting your search ranking.

Luckily, optimizing images is a pretty easy thing to do. All you need is a good image optimization tool like Optimole to run your images through it.

For more information, check out our guide on how to optimize images without losing quality.

Compressing images automatically using powerful machine learning algorithms

Additionally, you may want to consider lazy-loading your images. This tactic will prevent browsers from loading the images on your website until the user scrolls down to the image’s location.

How to Add Title Attributes to WordPress Images

While not essential for the image to function, title attributes provide a brief description of the image that appears when a user hovers over it.

This can improve the user experience by providing additional context for your visitors. For example, if you have an image of a delicious chocolate cake, a title attribute like ‘Homemade Chocolate Cake’ can be helpful.

An example of an image with a title attribute in WordPress

Title attributes can also be beneficial for WordPress SEO. While they don’t directly impact search ranking, they can help search engines understand the content of your image and improve your website’s accessibility.

For step-by-step instructions, check out our guide on how to add title attributes to your images in WordPress.

How to Find Free Images for Your WordPress Blog Posts

Images can make your articles stand out. However, you must respect the copyrights of other people and find images that you are legally allowed to use.

We are often asked by our readers about how to find the best, royalty-free images to use in their posts.

Finding images for blog posts

There are many websites where you can find royalty-free images to use. However, you will soon notice that images on those sites look overused and generic.

You can see our list of the best sources for free public domain and CC0-licensed images for more references.

Alternatively, you can also use AI to generate unique images and make your visuals stand out from the competition.

How to Categorize and Tag Images in WordPress

If you run a photography blog, then you will notice that WordPress does not allow you to sort photos and images.

Wouldn’t it be great if you could add tags to your images so that you and your users can easily browse them?

Luckily, there are some great plugins that allow you to do just that. For more details, see our article on how to add categories and tags to the WordPress Media Library.

Filter images by category

For a photography-related blog, the best option is to use Envira Gallery, which comes with an add-on to add tags.

Envira Gallery allows you to create beautiful, mobile-ready photo galleries in WordPress. Using tags, your users can easily filter and sort photos without even reloading a page.

Envira Gallery tags feature

How to Import External Images in WordPress

This question often comes up when you are migrating your site to WordPress. Some images on your website may still be pointing to an older location.

This is especially true for users importing blogs from Blogger, Squarespace, or WordPress.com.

While the images on your site may appear correctly, they are still loading from an external source. To solve this issue, all you need to do is install and activate the Auto Upload Images plugin.

Auto Upload Images plugin settings

Heads up: This plugin has not been tested with the most recent WordPress updates. That said, we’ve tested it ourselves, and it works fine for our needs. If you have concerns about using untested plugins, we recommend reading our article on the matter: Should You Install Plugins Not Tested With Your WordPress Version?

Discover a plugin that works better for this purpose? Then we’d love to hear your suggestions in the comments!

The plugin will check for external images once you update or save any post or page. You can manually do that for each post or page, or you can bulk edit all posts and simply click the update button.

For detailed instructions, see our guide on how to import external images in WordPress.

How to Require Featured Images for Posts in WordPress

When running a multi-author site in WordPress, some of your authors may not be familiar with the featured image functionality.

In this case, you may want to remind yourself or your users to upload a featured image whenever they are submitting a post in WordPress.

You can do this by installing and activating the PublishPress Checklists plugin.

Once activated, the plugin will display a red exclamation mark and a ‘Checklist’ tab informing users that this post requires a featured image.

Publish button will be disabled

You and your users will be able to save posts as drafts, but you cannot publish the post until you add a featured image.

See our article on how to require featured images for posts in WordPress for more instructions.

How to Set a Default Featured Image in WordPress

Finding the perfect featured image for every post or article is a tough task. Sometimes, you may not want to add a featured image to a post, but your theme may look awkward without one.

This is where a default featured image can come in handy. A default featured image is used when an article does not have a featured image of its own.

You can set a default featured image by using the Default featured image plugin.

Default featured image

For more instructions, please see our guide on how to set a default featured image in WordPress.

How to Create Additional Image Sizes in WordPress

By default, WordPress creates and saves different sizes of your uploaded images, including thumbnails. Your WordPress theme might also generate different image sizes.

If you want to create additional image sizes for your WordPress website, then you will need to register them by adding custom code to your theme’s functions.php file.

To learn more, please see our guide to how to create additional image sizes in WordPress.

How to Prevent WordPress from Generating Image Sizes

As explained before, WordPress creates multiple image sizes for your uploads, including thumbnails, mediums, and large sizes. These are helpful for displaying images in different contexts on your website.

However, if you’re using custom image sizes or want to optimize your website’s storage space, you can prevent WordPress from generating these additional sizes.

To find out how to do this, you can read our tutorial on how to prevent WordPress from generating multiple image sizes.

How to Prevent Image Theft in WordPress

Sometimes, users may steal images from your WordPress website to use on their own sites. This can be very frustrating, especially if you take your own photos or create your own graphics.

Luckily, you can prevent image theft by disabling right-click, adding a watermark to your images, disabling hotlinking, and adding copyright notices.

To learn more, please see our guide on how to prevent image theft in WordPress.

Need help with your WordPress design? WPBeginner Pro Services also offers Stress-Free WordPress Website Design to resolve all of your website design issues. Get your site looking its best with professional design help. Schedule a WordPress design consultation now!

We hope this article helped you fix some of the most common image issues in WordPress. You may also want to see our beginner’s guide to troubleshooting WordPress errors and our handy guide on how to reset your WordPress database to default settings.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. See how WPBeginner is funded, why it matters, and how you can support us. Here's our editorial process.

Editorial Staff

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!

Reader Interactions

264 CommentsLeave a Reply

  1. Jiří Vaněk

    I really like your Gutenberg editor tutorials. I learned WordPress with Elementor and ignored Gutenberg the whole time. It’s catching up with me now when I have to make sites for people who don’t have Elementor and sometimes the items in Gutenberg are really pretty hidden. Your how to and what to do series with the block editor are great.

  2. Mike

    I am out of things to try. All of a sudden, when I upload a photo to the media, it uploads normally, but when it opens up it is a blank page.

  3. Chevonne

    Hi When I upload an image to the page in edit screen it shows put when I preview the pages nothing shows. The images space is there but the website won’t display the image please help.

    • WPBeginner Support

      If it is only on the front end of your site, you may want to check with any caching you have on your site as that would be the most likely reason for it not displaying for your visitors but will display for you.

      Admin

  4. Mickey

    Hi,

    I have experienced similar issues, I exported my post from another website to another new site I am building when I tried importing, it didn’t come with the featured images. So after a serious research, I realized that, I need to export both post and media as well. When I exported post and media and imported on my new site everything was fine eventually. I felt I should post it here for those having same issues.

  5. Niek Biemond

    I got a shop page and the product pictures won’t load clearly and they are all blurry but when I use the zoom tool they are fully clear ( the pics are 3000×3000 px and 300 dpi) how can I fix the render quality?

    • WPBeginner Support

      You would want to check with your theme’s support to ensure you’re not having the images reduced due to the image sizes.

      Admin

  6. Daniel T

    Is there a way of setting the thumbnail/feature image, but not having that same picture in the actual post? This seems to be standard with my Theme (or is it for all?) , but i cant find an option to change that.

    • WPBeginner Support

      It would depend on your specific theme for how that is set.

      Admin

  7. adam smith

    My site, I changed themes, but the header image doesn’t show up. I can see it in the theme options, I can crop it, I can publish it, but it just doesn’t show on the page. Help!

  8. Caroline Street

    When I add featured image and then check the preview to see if everything is correct this text appears under featured image and the post text disappears?
    <p value="

    Please help! Thank you.

    • WPBeginner Support

      That appears to be an issue with your theme itself, we would recommend reaching out to the support for your specific theme and they should be able to assist.

      Admin

  9. Kym

    Great article – thanks!
    I was looking for info on ‘missing images’
    There were images on my site yesterday and today there is not!
    Would you have a resource or article you could point me to please?

  10. Somy

    THAK YOU
    I love you ..you solved all my problems

    • WPBeginner Support

      Glad our guide was helpful :)

      Admin

  11. Moazzam

    When I upload image from header image option in 2017 theme or even 2016 theme the next thing I see is nothing, image does not appear, only I see the select and crop button at bottom left. I’ve tried even changing browsers, using various sizes of images, small large, jpg, png…but can’t get the image. What am I missing?

  12. Ken

    My featured image are all of different sizes. I have set the Thumbnail size 150×150 in the Settings=> Media, but the featured image does not seem to follow any standard sizing. What could be wrong?

    • WPBeginner Support

      You would want to reach out to your specific theme’s support and they would be able to help fix that issue.

      Admin

  13. Gaby

    Hello,
    I am having the worst time uploading an image that is the right size for the thumbnail photo in WordPress.

    I tried changing the setting in media, the customized feature, changed in illustrator and still cannot get the main image or thumbnail to not be “zoomed” and “blurry”. Any advice?

    • WPBeginner Support

      Reach out to the support for your specific theme you are using to ensure they’re not doing something that would be overriding what you are doing.

      Admin

  14. sachintha

    Ihad a word press website , but when loading the website some images on my homepage are not loading(alt text is show on that image ). The same problem is on some article images .How am i fix this ?

  15. Kobby Nartey

    Please my site icon is showing on every blog post as the thumbnail and not my featured image when I share it on WhatsApp. Please what should I do to make the featured image visible instead?

    • WPBeginner Support

      You would want to reach out to your theme’s support to ensure there is not an issue with the theme itself.

      Admin

  16. Curtis

    Hello,

    I have a new developer working on my WordPress (Art Portfolio) site. He’s posted many horizontal images, but one kept coming up vertical. He tried and tried to post the image horizontally, but nothing worked. He checked the site and told me he saw no problems.

    I then went to view my site on Chrome (I’ve always used Firefox to view it). When I got to the image, it was posted horizontally! Why would this happen?

  17. Sivuyile

    Hi there, i have a problem with displaying background images on mobile devices. all images show on all devices but background images do not show on a mobile device, i have uploaded these images for all devices (desktop, tablet, and mobile) but background images won’t show when i view my site using my mobile phone and others, they do show when i use my PC, even when i reduce my screen to mobile they show, the problem occurs only when i view the site using a mobile. Your help will be highly appreciated, thanks.

    • WPBeginner Support

      You would want to reach out to your theme’s support for them to be able to take a look for any theme specific styling that could be causing your issue.

      Admin

  18. Ian Whyte

    Thanks for a very comprehensive post on Wordpress image problems.
    A short while ago I was very frustrated after loading an image onto a site.

    It appeared to load fine and looked great in the Images file. However when it was looked at on the site it was slightly out of focus. Nothing I seemed to do made any change on the post.

    Then an ‘expert’ whispered in my ear and said use the full sized image. Not the small or medium one which Wordpress will choose by default. Voila – once this was done the out of focus disappeared just like that.

    • WPBeginner Support

      You’re welcome, and thanks for sharing what was able to help you with your image issue :)

      Admin

  19. Arun Verma

    really good Article for everyone who wants to start learning something about how to use images in Wordpress, and superb stuff by sharing an outbound link of the different site for free pics.

    • WPBeginner Support

      Glad you found our article helpful :)

      Admin

  20. Byron Gordon

    Hello, got a question for wpbeginner.com. When you embed a link into an image in WordPress, it doesn’t seem to make the entire image clickable. For example, I’ve uploaded an image on the homepage of our website with an embedded link but when you put your mouse over the image, only the left and right portions of the image become clickable while the center portion of the image is not clickable. Is there anyway to get that fixed?

  21. mahmoud

    Hi, I am using a Publisher theme. But when I share the link on Facebook, the picture does not appear. i Use Yoast plugin too

  22. fereshteh

    Hello
    thank you for really useful article. I can see My Featured Image section but I can’t edit it when I want to change its image to new one. Is this for updating my woocommerce to new version (3.7.1)? how can I fix this? or how can I find the previous version?

  23. Lori

    My Featured Images are not showing up on my Home Page. In fact, my Home Page is blank except for the right side bar, which works perfect. I’ve watched SO MANY videos and believe I have set up all my widgets correctly…I even compared my settings with another successful blogger, but my Home Page is still blank. Any suggestions? Thank you so much!

    • WPBeginner Support

      For this question, you would want to reach out to the support for your current theme to ensure there isn’t a theme-specific setting that is overriding the default home page setting

      Admin

    • anurag dubey

      You can choose static 2 diffrent page for homepage and blog. I recommend go to reding into setting and choose your homepage display you latest post and delete the page name home and blog and then in the menu you copy your site link and make custom link and name it to home.

  24. Robb

    Thank you SOOOOO MUCH for this article!
    Especially the “6. How to Fix Missing Post Thumbnails / Featured Image?” section. I’ve been pulling my hairs out about those greyed-out thumbnails on my portfolios, I’ve tried a lot a fixing routines, but this simple and effective article did the trick!
    Thank you very much!

    • WPBeginner Support

      Glad our recommendations could help :)

      Admin

Leave A Reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.