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 Add and Align Images in WordPress Block Editor (Gutenberg)

Getting images to align just right in WordPress can be tricky. Misalignment can throw off your layout, leaving things looking cluttered or unbalanced, which often discourages beginners from adding images to their websites.

On the other hand, images can make your posts and pages far more engaging and visually appealing.

The good news is that the WordPress block editor, also known as Gutenberg, makes it very easy to add and align images. And at WPBeginner, we’ve experimented a lot with image display, so we will share what works best.

In this guide, we will walk you through adding and aligning images in WordPress so your content looks professional and polished.

Adding and properly aligning images in WordPress

Image Alignment in the WordPress Editor

Previously, WordPress used a text area with editing buttons as its default editor. One particular issue in the old editor was image alignment, which could make it difficult to get things lined up correctly on your WordPress website.

Even though there were options to align images left, right, or center, they didn’t always look good. Sometimes, images didn’t align, were not the exact size, or just looked odd.

WordPress 5.0 introduced a new WordPress post editor called the Gutenberg block editor. It fixed several problems with the old editor, including the image alignment issues.

In the following sections, we will explain how to easily add and align images in the new editor to create beautiful layouts for your WordPress blog’s posts and pages. Here’s a quick overview of all the topics we’ll share:

Let’s get started!

How to Add and Align Images in WordPress

The editor comes with the following blocks, which you can use to add images to your WordPress posts and pages:

  • Image
  • Inline Image
  • Gallery
  • Media & Text
  • Cover

Let’s start with a simple image block first.

You can click on the ‘Add new block’ button or type /image in the post editor to insert an image block.

Adding a new image block in WordPress post editor

This will activate the 3 buttons inside the blank image block.

Now, you can upload an image from your computer, select an already uploaded image from the media library, or insert an image by providing the image file URL.

Next, click the ‘Upload’ button and then select the image you want to upload from your computer.

As soon as you select the image, WordPress will upload it to your media library and insert it into the image block.

Adding an image using the image block

Now, you will notice a toolbar on top of your image and some image block settings in the right column.

To align your image, you’ll be using the toolbar that appears on top of the image.

Image alignment buttons in WordPress post editor

The image block gives you the following image alignment options as buttons in the toolbar.

  • None
  • Align left
  • Align center
  • Align right

Go ahead and click the ‘Align center’ button to center your image in your post.

Center align an image in WordPress

How to Perfectly Align an Image Next to Text

A lot of times, you may need to align an image next to text perfectly. WordPress block editor makes this easy by adding the Media & Text block.

This block basically adds a two-column area – one column for images (media) and the second column for text content.

Media and text block in WordPress post editor

Simply upload your image by clicking the ‘Upload’ button.

Then, you can add the text you want to display next to it.

Adding media and text to the block

If you need a longer description, go ahead and type it in.

The image’s alignment will automatically adjust to the height of the text in the next column.

Image size adjusts to align vertically

The WordPress block editor also includes a block for adding image galleries. This allows you to easily display images in a grid of rows and columns.

The Gallery block comes with similar alignment options in the toolbar. By default, the block will display the images in a 3-column layout. So, your image gallery might look like this:

A 3-column gallery

You can adjust the gallery layout by shifting the slider to the left or right. Alternatively, you can just type in the number of columns you want in the box.

Here, we tried out the 4-column layout:

A 4-column gallery

If your gallery doesn’t look good due to differences in image sizes, then you’ll need to adjust its alignment.

In the post editor, you can click on the gallery. Then, you can click the ‘Select parent block: Gallery’ icon to open the customization panel.

The Select parent block: Gallery icon

From here, let’s make sure to enable the ‘Crop images to fit’ option.

As soon as you do that, WordPress will adjust the gallery to the center.

Crop images to fit to make your gallery looks neat

The default gallery feature in WordPress is quite good. However, if you regularly add photo galleries to your WordPress posts and pages, then consider using a photo gallery plugin like Envira Gallery.

These plugins will give you more options to align images in your photo galleries, display them in the popup, and style them differently.

For more details, see our tutorial on how to add an image gallery in WordPress.

How to Add Two Images Side by Side in WordPress

The easiest way to display 2 images side by side in a WordPress post is to add both images to a Gallery block.

Display two images side by side in WordPress posts and pages

To open the Gallery block customization option, you can click on the gallery and then once again on the ‘Select parent block: Gallery’ icon.

This will open the customization panel on the right side.

Gallery block icon to open customization options

From here, simply select a 2-column layout for the gallery block to display both images next to each other.

You can also enable the ‘Crop images to fit’ option to make sure both images are the same size and center-aligned.

Crop images to fit enabled

More Ways to Add and Align Images in WordPress

Apart from the image, media and text, and the gallery block, you can also use the Cover block to add a cover image.

In modern web design, cover images are used to create highly engaging content layouts and highlight different sections of a page.

The cover image block has the same alignment options as an image block. You can add text over the image and choose an overlay color from the block settings. The best part is that you can check the ‘Fixed Background’ option, which creates a parallax background effect.

Cover image in WordPress

To learn more about using cover images, check out our article on the difference between featured and cover images in WordPress.

So far, we have talked about adding images directly to your posts and pages. What about images from third-party sites?

The block editor makes this easy as well. You can add images from popular social sharing sites, including Instagram, Facebook, Flickr, Imgur, Photobucket, and more.

For example, if you want to add an Instagram photo, then simply add the Instagram block to the post editor and enter the URL of the post you wish to share.

Instagram embed in WordPress

Then, you can just click on the alignment you want in the toolbar. Embed blocks also allow you to easily embed videos in WordPress.

For more details, please see our guide on how to embed Instagram in WordPress.

💡 Get Your Dream Site – Built by Real WordPress Experts

Say goodbye to endless design templates and confusing site builders. We make launching your ideal website easy with a dedicated project manager, a custom WordPress design, and multiple revisions to perfect the look.

You dream it, we’ll bring it to life – fast, reliable, and tailored to your vision. Schedule a consultation with our WordPress Website Design service team today!

Bonus Tip: How to Center Align a Video in WordPress

If you add a video in WordPress, it will align to the left by default. So, if you want a different look, you’ll need to adjust it.

Center-aligning videos can make your content look cleaner by getting rid of empty space on one side, giving it a more professional feel.

Aligning video to center

Just keep in mind that if the video is smaller than your content area, WordPress will still place it on the left by default.

To learn more, then you can read our guide on how to center-align a video in WordPress.

We hope this article helped you learn how to easily add and align images in the WordPress block editor. You may also want to see our guide on how to optimize images to speed up WordPress and our expert pick of the best design software.

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

63 CommentsLeave a Reply

  1. Jiří Vaněk

    Gutenberg is still a big unknown for me. I’ll admit that I only started discovering it after WordPress 6.4 arrived and reading these pages. For a long time, for example, I could not figure out how to place an image and text next to each other (in Elementor it was a completely simple matter). After reading this article, I can do a little more with Gutenberg. Thanks for that.

    • WPBeginner Support

      You’re welcome :)

      Admin

  2. fred dugas

    will this work with Iframes? I edit a custom HTML block and add iframe and the save and the add is lining up all the way to the left where all the other blocks are centered.?

    • WPBeginner Support

      It would depend on the iframe but normally iframes will not automatically have alignment options.

      Admin

  3. Harry Goldhagen

    How do you align Featured Images that appear on the automatically generated Blog page and Category page? Clicking on the image opens the post, and there doesn’t seem to be an alignment setting for Featured image when filling in the post settings.

    • WPBeginner Support

      For the featured image, that would be determined by your theme. If you check with your specific theme’s support they should be able to assist with the alignment of your featured image.

      Admin

  4. john McIntyre

    I wish to have all captions on my site, the same size and font.
    How is this achieved?

    • WPBeginner Support

      Unless your theme has a specific setting for it, most themes should have the text uniform if it is all the image caption and not a different text block.

      Admin

  5. Sharon

    I’m wanting to change the default for uploading an image to be centred every time. To change each image I upload to centre each time I add an image is so time consuming. Can I change the default to centre?

    • WPBeginner Support

      There is not a simple method we would recommend for beginners at the moment but we will keep an eye out for something we would recommend.

      Admin

  6. Amanda A.

    I am trying to use the Block Editor to display two images side by side. I used the two column feature then image blocks in each column. While designing, it displays correctly, but when I “preview in new tab”, the side by side columns are gone and the images are stacked. What am I doing wrong? Is this a common issue? How can I fix this?

    • WPBeginner Support

      You may want to ensure the images aren’t too large for them to be side by side in your specific theme for the most common reason for that issue.

      Admin

  7. Sheryl Zeiset

    I’m trying to learn how to use the new block editor. When I click on the Add block button and choose image to add a photo, I only get the ‘insert from URL’ option and I can’t find a way to add photos from my Media Library. Can you help?

    • WPBeginner Support

      You would want to check closely to find the text next to the upload button for selecting the image from your media library

      Admin

  8. Luther Mckinnon

    I have been publishing a blog for many years. I have learned to dread the introduction of a new system. Doing a simple thing like adding photographs is now very difficult.

    • WPBeginner Support

      Hopefully, once you are comfortable with the new system it becomes easier for you :)

      Admin

  9. Ward

    Great information, problem is that back end it works but front end it always aligns to the left. Would it be possible that this has something to do with my Elementor template?

    • WPBeginner Support

      If you are using a page builder there is a chance that your page builder is overriding the styling and you can reach out to your builder’s support for assistance.

      Admin

  10. tanmay

    absolutely amazing feature its not every cup of tea to use HTML editor

    • WPBeginner Support

      Glad you like the block editor feature :)

      Admin

  11. Louie Adem

    just started WordPress yesterday. Totally a beginner and so happy wpbeginner provided me the “trainer wheels” to jumpstart. The education in this website is so valuable. Can’t thank you enough.

    • WPBeginner Support

      Glad we could help get you started :)

      Admin

  12. BadlyDrawmWolf

    Thank you for this little gold nugget – really struggling getting in to the “new” way of handling my blog and almost giving up and searching for other alternatives…. :)

  13. Karen

    You mention “Inline Image”, but I don’t see any such block. Your article was written awhile ago but supposedly updated in Jan. 2020 – did that block go away and you forgot to remove it from this article? Or a better question: How can I add an inline image within another block like Paragraph or Heading?

    • WPBeginner Support

      The inline image block is not currently available but you can normally recreate the formatting with the text and image or the standard image block

      Admin

  14. Ted Strutz

    When I add an image from my media the image toolbar does not come up to align left or right. I can change size of image.

    • WPBeginner Support

      You would want to ensure you have not set it to be at the top of the page instead of how we have it at the moment.

      Admin

  15. Hannah

    Hello, I have aligned all images using the block editor and everything looks fine until I preview?

    Then some images have become far bigger than the others, I have a gallery of two images suddenly sitting on top of a single image. Everything has moved around randomly!

    Even when I published it, it was still all wrong. I would love your help, thank you!

    • WPBeginner Support

      You would want to reach out to your theme’s support to ensure there isn’t a styling conflict, otherwise, you could try disabling your plugins to see if this is a plugin conflict as well.

      Admin

  16. Harry

    Hi, I’m looking to align shortcodes next to one another like you describe with the images is this possible? Many Thanks

    • WPBeginner Support

      That would depend on the shortcodes themselves

      Admin

  17. Ap

    Hello,
    How do you arrange the positioning of the title for the cover blocks?

    You have that option in your bar, but for some reason, when I click on cover block, there is no text alignment option.

    Any ideas on this?

    Thank you for the great article.

    • WPBeginner Support

      You would want to check the top of your page as that would be the other location the alignment options would be rather than floating over the element

      Admin

  18. Cheryl

    How do you make an image clickable with a clickable link? I’ve been looking for tutorials and they all seemed based on a prior Gutenberg block which since has changed an the tutorials no longer match the block.

    • WPBeginner Support

      You would want to check the top toolbar for the current location for where to add a link to an image

      Admin

  19. Alejandro

    Hello, Is it possible to write an image caption right below the image when using the “Media & Text block”?

    • WPBeginner Support

      It would depend on your specific theme for the styling but you should be able to

      Admin

  20. Lancer Kind

    Nice! Thank you so much!

    • WPBeginner Support

      You’re welcome :)

      Admin

  21. Pete Newman

    There is an existing issue of incompatability between Gutenberg and themes. Do you have a list of themes that are compatable with Gutenberg (and that allow full functionality of Gutenberg)?
    Thanks and regards,
    Pete.

  22. Pete Newman

    I have been using wordpress for years but have been a bit absent lately. Gutenberg is a headspin. I follow these instructions but simply cannot align images in an image/text block. When I go to preview the image is aligned extreme hard left of the page with no margin at all. Any solutuions on offer?
    Thanks!!

      • Pete Newman

        Thank you! Excellent support. I added the classic editor plugin and the disable Gutenberg plugin and was able to create an approximation of what I want. Looking forward to Gutenburg functioning as intended and developers catching up – it is a great idea.

        • WPBeginner Support

          Glad we could help :)

  23. Jimmie

    But you can’t link images in a gallery? That makes the gallery function less attractive

    • WPBeginner Support

      If each image needs its own link then setting up columns would likely be what you’re looking to do :)

      Admin

  24. Roxana Snedeker

    What is the best way to add multiple images at once, I can’t seem to add more than one at the time :(

    • WPBeginner Support

      If you want to add multiple images in the same area, you would want to take a look at the gallery block to add multiple images in one section

      Admin

  25. Aaranja

    How to add an image directly in the “Code Editor”, without passing by “Visual Editor”?

    • WPBeginner Support

      You could disable the visual editor under Users>Your Profile but that would prevent you from using the visual editor for other sections.

      Admin

  26. Alice

    I’m centering all of my images correctly in the editor, but they are all showing up as left-aligned in preview and live posts no matter what. Do you know what might be causing this? It’s driving me so crazy!

    • WPBeginner Support

      Your theme may be overriding the styling you are setting. If you reach out to your theme’s support they should be able to assist.

      Admin

  27. Anne

    I would like to have an image next to a file (pdf) – all on the same line. Can I do that in one block, or would I need to create two? Thank you!

    • WPBeginner Support

      You would want to add the column block to split the content and allow you to display the content like that.

      Admin

  28. Suzy Algar

    I am having creating captions for images and downloads that appear in my files. I don’t know where to go once I have the image in my files.

    • WPBeginner Support

      If you’re trying to add the image to a post or page you would normally add an image block and then select the file you want to use in the block

      Admin

  29. Roxana Safipour

    So now how do you do “no alignment”, where the image is on the left and has no text wrapping around it? This used to be easy with the no alignment option, which is now gone. Please bring this back! I am going crazy trying to figure out how to get my image on the left (not centered) and with no text next to it, but the text keeps wrapping around it automatically!

    • WPBeginner Support

      For what it sounds like you’re wanting, if you don’t specifically set the alignment for an image, the image should set itself that way.

      Admin

      • Ben

        Just a quick followup on this, as it was annoying me as well. There’s a simple answer but it’s sort of not that obvious as I was looking for a setting – just press the selected alignment button again to turn off the alignment and revert to the default no alignment.

  30. Jesse

    Great post very useful.I have ugrade to wordpres 5.1 but now have problem with linking image to url. Can you help me?

    • WPBeginner Support

      If you’re using the block editor, in the image block’s settings there should be a Link Settings section for you to set where an image links to.

      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.