Image Aligned Left with Text on Right

Wrapping Text Around an Image in WordPress Gutenberg

Written by

in

With the WordPress content editor, Gutenberg, the method for wrapping text around an image has changed. In the Classic Editor, you place your cursor at the beginning of a paragraph and click the Add Media button. Align the image left or right, and your text will wrap. In the Gutenberg editor, you use an image block and a text block. I’ll show you the best way to do this.

Before we get into the specifics, a quick note about aligning versus wrapping. Aligning text and image positions the two items next to each other in 2 separate columns. Wrapping involves more interaction with the image, since the text positions itself around the image. In print design, you can create a text wrap on all sides of an image (top, bottom, left, and right). In web design, the text can wrap on the top and bottom, but only on one side.

BEST METHOD FOR WRAPPING

Step 1

I find it best to start by placing an image inside an image block. There is no default alignment. We’ll apply an alignment in Step 3.

Cosmos
Cosmos ©2011 Anne S. Katzeff, pastel

Step 2

The next block will be the text block. I’ve used a fun Lorem Ipsum Generator (CupcakeIpsum) to collect fake text and fill the text block in my example:

Step 3

When done with the text, select the image block and set the alignment left or right. The text will immediately reposition itself on the opposite side of the alignment chosen for the image. When the image is aligned left, the text will move into place on the right side; when the image is aligned right, text moves into place on the left side. With a center-aligned image, the text stays beneath it.

Image Aligned Left with Text on Right
Image Aligned Right with Text on Left
Image: Align Center with no Text Wrap

Step 4

If the text doesn’t move, it means the image is too wide and there’s not enough space for the text. Simply select the image block, grab one of the round nodules, and drag to scale smaller. The text will begin to wrap as soon as there’s enough room for it.

Video Tutorial

If you prefer, you can watch the video tutorial I made that shows you how to wrap text around an image in WordPress Gutenberg:

Comments

18 responses to “Wrapping Text Around an Image in WordPress Gutenberg”

  1. Pamela Kramer Avatar
    Pamela Kramer

    I just wanted to thank you. I was ready to tear out my hair trying to use this new editor and getting the text to wrap around the images. Your video really helped! Thanks again.

    My best,
    Pam

    1. ProfK Avatar

      Great to know that the tutorial was helpful!
      Thanks for taking the time to write, I appreciate it!

  2. Scott Siegwald Avatar
    Scott Siegwald

    Thanks. But I’m looking for the wrap that continues under the image after being aligned left or right. I thought you were going to do that, but your video never showed it working. When I try, it “aligns”, but the text stays in the column width of the text next to the image. not a wrap, but an align.

    1. ProfK Avatar

      Hi Scott, The method I describe here in the blog as well in the video does wrap the text on one side with the overflow continuing underneath the image. The original example showed a new paragraph continuing underneath the image, which I now realize is confusing. So, I changed the text in this blog post to better illustrate the wrapping. Thanks for your feedback, which provided me with an important perspective.

  3. skierpage Avatar
    skierpage

    I found that my high-res images don’t “nest” into the following paragraph until I reduce the image’s size: in Gear icon [Settings] > Block > Image settings, set a size or percentage for image settings. Otherwise the image defaults to being full-width, and so changing its alignment has no effect.

    If the image is taller than the paragraph of text beside it, the floating image will continue to push the next paragraph over. If you don’t want this, you should be able to clear any outstanding floating alignment with the CSS clear property; I used to use a lot of br style=”clear: both;” after nested images, but I couldn’t get it to work in Gutenberg using “Edit as HTML”.

    1. ProfK Avatar

      You’ll need to add a class to your stylesheet, something like “clearboth”.
      .clearboth {
      clear: both;
      }
      Then use that class in the “Advanced > Additional CSS class(es)” section of the block: clearboth.

  4. Kathy Avatar
    Kathy

    Thank you that was really useful and very clear

  5. Lisa Avatar
    Lisa

    This was so helpful! Your description was clear and it worked just like you said, so I didn’t have to watch the video. Thank you so much!

    1. ProfK Avatar

      Great, Lisa, glad it was helpful! Thanks for your feedback.

  6. Celeste Avatar
    Celeste

    Thank you for this lesson! It was clear and helpful as I transition to the block editor. Something I wish you had addressed, however, was padding or whitespace. When I align my image the text is bumped up against the image. Can I add padding-right or padding-left somehow? Or did you already have whitespace around the image in the media library?

    1. ProfK Avatar

      Thanks for your feedback, Celeste. The margins and padding around an image are controlled in the stylesheet. Identify the image block element using the browser’s developer tools. Then, you can override the property values in the Customizer.

  7. Joe Avatar
    Joe

    Thank you! This article bailed me out in the middle of a post that I’m working on. I would’ve never thought of using an image block as evidenced by me putting a photo in the post and thinking this ain’t going to work like the old days.

    1. ProfK Avatar

      Great to know it helped you out Joe. Thanks for letting me know, very appreciative!

  8. Chris Avatar
    Chris

    I followed your clear instructions in the video, and in my case – with a small image – the image certainly jumps to the left or the right, but – it’s all the way up against the left edge of the page, or the right edge of the page, while the text remains constrained within some unseen margins. I’m guessing my page needs some boundaries, but the text is clearly following ‘some’ limits!

    1. ProfK Avatar

      Hi Chris, With some block themes (like 2024), the image needs to be placed inside a group block in order to control the width constraints. Give it a try. If you continue to have trouble, please provide the site URL so I can try to help you out.

  9. jon doe Avatar
    jon doe

    An easy step that wordpress had made nearly impossible. Didn’t think anybody could actually pull it off but they did.

  10. Donald D. Groff Avatar
    Donald D. Groff

    This has already been said in your site comments, but I’m compelled to directly say a thousand thanks for one little aside in your instructions for text-wrapping around images in WordPress Twenty Twenty-Four.

    NOTE: With the 2024 theme (and perhaps other block themes), be sure to place the image inside a group block (or group the text and the image together).

    I’ve built plenty of personal sites over the years but for the past two months have been tearing my hair out over the text-wrap I wanted with 2024. Using the “official” wrap guidelines left my images protruding into the margins. I must’ve viewed dozens of tutorials, etc., but it wasn’t till I came across yours today that my problem was solved.

    thank you, thank you, thank you. you have a new devoted follower, good luck with your art and your work.

    best,
    Don
    Philadelphia, PA

    1. ProfK Avatar

      Hello Don,
      I am so happy to hear this feedback from you. Thank you for taking the
      time to reach out and let me know that my post assisted you!

      “Using the “official” wrap guidelines left my images protruding into the margins.”
      The very same thing happened to me on my tutorial site. I mumbled to myself:
      “what the heck is this?” And then had to figure out the solution.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Sign up to get periodic updates on Anne’s design and art adventures, and receive useful info. via her blog.

* indicates required




I’d like to subscribe to:

Intuit Mailchimp

Looking for Something on this Site?
Copyright

© 2000-2026 Anne S. Katzeff. All rights reserved. Unless noted, all artwork and text are copyrighted by the artist. Images may not be reproduced, manipulated, or used in any way without Anne’s written permission.