CSS Shapes: Breaking the Rectangular Design Shackles

By Patrick Catanzariti

The capabilities of HTML5 and CSS3 completely outshine what we could do on the web just five years ago. The CSS Shapes Module Level 1 specification has the potential to break us out of the rectangular limitations of the web and transform web design to new heights. It allows elements to be styled in various shapes (think circle or pentagon-shaped divs) and for text to wrap around elements in much more natural ways (wrap your text around the edges of your curvy design rather than having to stick to square boundaries). This article will go over the possibilities of CSS Shapes with a bunch of little demos to show what’s possible and help you start exploring!

About the Shapes Spec

The specification is a candidate recommendation which is “an explicit call to those outside of the related Working Groups or the W3C itself for implementation and technical feedback”.

Basically, this means it’s ready for web developers in the community to get in there, give it a shot, and share their thoughts and ideas to help get this specification as solid as possible. It’s not ready for mainstream usage yet but it’s at the stage when it’s so crucial for the web development community to get on board and help explore how this will be used in the wild.

If you’re a dev who doesn’t usually tinker with things that aren’t widely available and aren’t cross-browser compatible, this article may not be for you — however I’d encourage you to try out a demo or two if you have the time and really see where you might take these new features in your future designs.

What You’ll Need to Experiment with CSS Shapes

In order to develop and experiment with the spec, you’ll need to ensure you’re using a supported browser. It currently works in the following:

If using Chrome (not Canary), paste this into your address bar:


Then click “Enable” under “Enable experimental Web Platform features” and choose “Relaunch Now” to restart your browser and give it brand new CSS superpowers.

With those introductions out of the way, let’s get right into what the Shapes spec has to offer.

The shape-outside Property

The first area we’ll explore is the new shape-outside property. This works to define a different float area around an element. Rather than text flowing around the floated element solely as a rectangle, the element can wrap text around it as a circle, polygon, or ellipse. It cuts out a new area within the float box boundaries of the element, into which text is allowed to wrap.

Throughout my demos, I’ll be bringing a few snippets to life from the book The Children’s fairy geography, or a merry trip round Europe by F. Winslow. The British Museum were kind enough to release a bunch of works into the public domain and this children’s book happens to be one of them (and also happens to have a bunch of differently sized images!).

Our first and super simple example looks like this:

Before rounded corners

The HTML looks like this:

<img src="" 
     class="lapland" />
<p>They can bend bows most easily that the most powerful Swedes or Norwegians
could not bend at all. They dress,as you see, altogether in skins or coarse wool. 
The women dress very like the men, turning their hair up in a funny kind of knot.</p>

We’ll add the shape-outside property to the image (.lapland) element’s CSS:

.lapland {
  float: left;
  shape-outside: inset(1% round 45%);

As a result, the image’s corners become nicely rounded to match the illustration’s natural border radius:

After rounded corners

And for those viewing on a supporting browser, here’s a CodePen demo:

See the Pen CSS Shapes Demo #2 by SitePoint (@SitePoint) on CodePen.

We’ll take a closer look at this example and the inset function options further in the next section.

What Kinds of Shapes are Possible?

The shape-outside property allows us to use a few different functions to define the shape:


The inset() function allows you to define an inner rectangle within the float area. This would be useful if you have a design where you’d like the text to overlap part of a rectangular image. Maybe you’ve got a bit of a subtle bleed of colour around the image that you don’t mind the text moving into, or there’s a lot of white space around the image that you’d like to preserve in some cases but want to style out in others. The inset function would make this all possible!

You define your top, right, bottom, and left positions of the rectangle similar to how you define margins or padding:

shape-outside: inset(10px, 5px, 10px, 5px);

You can shorten the value just like in margin/padding values, so the following gives an inset rectangle that is 1% from all edges of the element:

shape-outside: inset(1%);

You can also give this rectangle various border-radius styles, providing various opportunities for rounded containers. This is actually where I see the inset function being especially valuable in designs.

If you add “round” and then specify the size using the regular border-radius syntax, the aforementioned possibilities of rounded containers will appear. This is what we did in our Laplander example above.

I’ll give a few variations to explain our earlier example a bit more. The code below gives the element a 10px border-radius that is inset from the edge of our image by 1%:

shape-outside: inset(1% round 10px);

Our example above follows this pattern, but the radius is much more rounded to match our image:

shape-outside: inset(1% round 45%);

You can go further with these settings by giving it a different border-radius on each corner. The following, for example, would give the top left 5px, top right 10px, bottom right 5px, and bottom left 5px:

shape-outside: inset(1% round 5px 10px 5px 5px);


If you’ve got a genuine circle shape in your image, you can set the float area to match the circle like so:

shape-outside: circle();

To demonstrate how this works, let’s say we had the following:

Before circle

By adding the code above to the image in the top-right of the above screen shot, we get this:

After Circle

CodePen example:

See the Pen BDqLe by SitePoint (@SitePoint) on CodePen.

Setting the Radius of the Circle

You can set the radius of the circle in the first argument of the circle() function.

By default, the circle’s radius is half of the element’s width:

shape-outside: circle(50%);

You could set the radius to 25% to set the circular float area to be a quarter of the width of the element:

shape-outside: circle(25%);

Note: Percentages in circle() are computed by a formula using both width and height in cases where the element is not a perfect square. (Thanks to Razvan Caliman in the comments for pointing this out)

There are two other ways to set the radius of the circle, which are newer concepts but quite neat: closest-side and farthest-side define how the browser should work out the radius of our circle using the boundaries of the element itself. They will make no difference if our element is a square though, only in cases where you’ve got a rectangular element.

closest-side calculates the radius of the circle from the edges of the element closest to the center. This is th default, so using circle() on its own, is equivalent to circle(closest-side). If we have a rectangular element and we use the following:

shape-outside: circle(closest-side);

closest-side will ensure that the circle fits snugly inside the container as shown in the image below (I’ve added an orange border around the edge of the image so you can see where the boundaries are):

After circle closest side

See it on CodePen:

See the Pen CSS Shapes Demo #3 by SitePoint (@SitePoint) on CodePen.

farthest-side, on the other hand, calculates the radius of the circle from the edges farthest from the center. This will clip the circle on one pair of edges. If we have a new rectangular element like the one above but with a clipped circle image, we can use farthest-side:

shape-outside: circle(farthest-side);

That’ll allow us to wrap text on elements like so:

After circle farthest side

See it on CodePen:

See the Pen CSS Shapes Demo #4 by SitePoint (@SitePoint) on CodePen.

Moving the Center of the Circle

You can use the keyword at to move the center of the circle. You might do this in cases when the circle isn’t precisely in the center of the image, or in cases when you’re looking to achieve a semi-circle from one edge. For example, if we use this CSS on a tall image:

shape-outside: circle(farthest-side at left);

We can achieve a circle whose center is to the left of the image and whose height matches the height of the element:

Semi circle float area

On CodePen:

See the Pen CSS Shapes Demo #5 by SitePoint (@SitePoint) on CodePen.

You can use a bunch of different positioning values for the center of the circle. Theoretically, everything that the CSS position syntax allows:

shape-outside: circle(closest-side at center);
shape-outside: circle(closest-side at 10% 10%);
shape-outside: circle(closest-side at center);

You can even get quite specific, specifying the radius of the circle and the position. For example, the CSS below would create a circle that is half the width of the element, whose center is at the very left of the element (0) and 25% from the top:

shape-outside: circle(25% at 0 25%);


If you’ve instead got an oval shape, rather than a circle, you can use the ellipse function. With this, the height and width of the ellipse will be the height and width of your image, unless you define the radius similar to how you’d define it for the circle — just with two values, one for the radius of x and one for the radius of y.

The following code:

shape-outside: ellipse();

Results in this:

Basic ellipse

On CodePen:

See the Pen CSS Shapes Demo #6 by SitePoint (@SitePoint) on CodePen.

Setting the Size of the Ellipse

We can make an oval of a different size in the same way as defining a circle radius, just with two values: One for the width and a second for the height:

shape-outside: ellipse(25% 10%);

There’s probably a better real-world example, but this gives an idea of what it would look like. I’ve got an image with a smaller oval inside it at the size defined above (I’ve added an orange border again to show where the image lies):

Teeny ellipse

See it on CodePen:

See the Pen CSS Shapes Demo #7 by SitePoint (@SitePoint) on CodePen.

You can also define width and height via the closest-side and farthest-side values as we did with the circle, only with the ellipse we again use two values: One for the width and one for the height:

shape-outside: ellipse(closest-side closest-side);

Moving the Center of the Ellipse

You can move the center of the ellipse using the same method as the circle element:

shape-outside: ellipse(25% 10% at 0 25%);


The polygon() function lets you define any number of points for your shape, allowing you to get your text flowing around even the most awkwardly shaped image!

You define polygons by setting coordinates for each point. The coordinates can be in pixels or in percentages. The first point must be able to link up to the last one:

shape-outside: polygon(x1 y1, x2 y2, x3 y3, x4 y4, x5 y5);

Take this example with a very fancy illustration making up the “D” at the start of our page:

Fancy image D without new wrapping

We can then define a polygon float area like so:

shape-outside: polygon(88% 0, 90% 15%, 83% 22%,
                       93% 31%, 100% 36%, 72% 73%,
                       35% 75%, 19% 100%, 0 100%,
                       0 0);

That’ll adjust the float area so that our text wraps around the specific polygon we’ve defined:

Fancy image D wrapped

On CodePen:

See the Pen CSS Shapes Demo #8 by SitePoint (@SitePoint) on CodePen.

But… Working out Polygon Coordinates is Hard!

I agree. It’s a pain to work out when it comes to complicated images, especially when using percentages! There is a Brackets extension that’ll help you out here.

If you’d rather not use Brackets, there’s a simple online tool for working out the polygon shape you’d like to use.

Definitely give that a try if you’re looking to have a faster way to come up with the polygon coordinates. Or you can set up polygon shapes using images themselves, which I’ll discuss next!

Shapes from Images

One of the very handy features of CSS Shapes is that if you’ve got a transparent PNG or GIF image, you can use the alpha channel to define your float area. It’s as simple as these two lines:

shape-outside: url(b.png);
shape-image-threshold: 0.0;

The URL format is just like the format used to refer to a background-image and it can be either the same image as the element or a totally different one. You could create new images whose sole purpose is to define the alpha channel for the shape if you so desire. This is slightly easier than polygons, but would add an extra HTTP request.

The shape-image-threshold defines the level of opacity you’re wanting to pick up. 0.0 is fully transparent while 1.0 is fully opaque.

In my example, I’ve gone with 0.0 as my image has completely transparent areas that define the float area:

Our image with transparency

The example code from above will result in this:

Polygon by image

And here’s the CodePen demo:

See the Pen CSS Shapes Demo #9 by SitePoint (@SitePoint) on CodePen.

Editor’s Update: As we discussed in the comments, the CodePen demo above, when tested in Chrome Canary with the proper flag enabled doesn’t seem to work properly due to a cross-origin bug in either Chrome or CodePen. It will work if you refresh the page a few times, but for now you can refer to Patrick’s demo for a working version.

One important point — if you load the HTML from your filesystem (e.g. file:///Users/philkensebben/Web/yourfile.html) rather than from a web server, you’ll run into a Cross-Origin Resource Sharing error like this:

Image from origin 'file://' has been blocked from loading by Cross-Origin Resource Sharing policy: Received an invalid response. Origin 'null' is therefore not allowed access.

So make sure to test this on a remote web server to avoid any confusion over why it’s not working!

Shapes from the Box Model

Another choice for defining your float area is to use the element’s built in box model. For simple rounded corners, you can also get the rounded corner effect by using box models for your float area too.

You can use the various box model areas as your float area. I’ve added an image below to remind you of the various parts of the box model in CSS:

Box model example

  • The blue area is the margin-box. This is made up of the margin of the element and is outside the element’s boundary.
  • The black area is the border-box. In the case of the example above, we’ve got a border of 2px.
  • The orange area is the padding-box. This is the area that surrounds your content (e.g. our image).
  • The image itself is in the content-box. This is the box area that holds our image.

You can use these boundary areas as the float area like so:

shape-outside: margin-box;
shape-outside: border-box;
shape-outside: padding-box;
shape-outside: content-box;

Basically, whichever you define will be where the text will wrap to. If you define the shape-outside as margin-box, then the text will wrap up to the edge of your margin (e.g. the blue area in the example above). If you define it as border-box, it will wrap to the edge of your border, and so on.

One of the simple uses of this is to give your image float area rounded corners (just like we did with inset but a bit simpler to implement and maintain). This CSS will add a 5px gap between our image and the text, while also wrapping the text around the image with a 150px border-radius value:

border-radius: 150px;
margin: 5px;
shape-outside: margin-box;

Which looks like this:

Example of using margin-box and border-radius

And on CodePen:

See the Pen CSS Shapes Demo #10 by SitePoint (@SitePoint) on CodePen.

The same effect with the border-radius can be done with border-box, padding-box, and content-box — it just changes how close the text gets to the image.

The shape-margin Property

You also have the option to add space around your defined CSS Shape’s float area to ensure that the text doesn’t run into the edge of your images. This is handy in cases where you’re not using the box model values for your shape.

The spec says you can use either a length (e.g. px, em. rem, etc.), percentages, or a calc() function value. Only Chrome Canary currently supports percentages, but Chrome stable supports lengths and calc() functions (as long as those calc() functions do not include a percentage). A few examples include:

shape-margin: 10px;
shape-margin: 1em;
shape-margin: 5%;
shape-margin: calc(2em - 1px);

Combine a Few Ideas and Explore!

Don’t be fooled by the ye olde illustrations in my examples — the spec can be used for more modern looking designs with photos and such too:

Polygon in colour

See it on CodePen (this demo is too awkward for an embed).

Soon enough the web will be buzzing with all sorts of shapes! Designers shall rejoice and developers shall breathe a sigh of relief that finally they can do things their print friends have been doing for years.

Please do get involved, experiment, and share your findings to help develop the spec into something we can use confidently and happily in the future. You can provide feedback to the W3C here, or get in touch with the Adobe Web Platform team.

Further Info

If you’re super keen and want to read more on the CSS Shapes spec, check out the following links:

  • Carl Vaillancourt

    Wow. This seem very useful to me, hope it gets supported! Great article.

    • Patrick Catanzariti

      Thanks Carl! Glad you enjoyed it :)

  • Tumikia Watu-Khuthaza

    Nice!! Takes me back to my graphic design days. I am looking forward to it!

  • Arnold Wotherspoon

    Any reason why the “Shapes from Images” Codepen (Article “Britain”) isn’t working?

  • Patrick Catanzariti

    Good find Arnold! I could have sworn that was working on Codepen before. It is failing because the b.png image we refer to in the css for the transparency mask isn’t being found. I’ll see if I can get that fixed :) Thanks for letting me know.

    In the meantime, I’ve got a working version of that example here:

    • LouisLazaris

      Hmmm… that’s odd. I could have sworn it was working too. I’ve corrected the URL to the image (which was wrong), but I still can’t get it to work in Canary with the flag enabled. Your version works, though, which is weird. I think it might be a CodePen thing, though, because it’s not working in your original CodePen either:

      Any idea what’s going on there, @patrick_catanzariti:disqus ?

      • Patrick Catanzariti

        Ah ha! To have a reference to the b.png in the CSS, it needs to be referencing an image on the same server, otherwise the browser gets upset with a cross-origin resource request issue:

        Image from origin ‘’ has been blocked from loading by Cross-Origin Resource Sharing policy: No ‘Access-Control-Allow-Origin’ header is present on the requested resource. Origin ‘’ is therefore not allowed access.

        It might be something we can’t do with Codepen, does Codepen provide the ability to host images directly on the domain?

        • LouisLazaris

          Well, those images I’m including *are* actually hosted with CodePen. I noticed when preparing your demos that CodePen lets us host images with them, because SitePoint doesn’t let us hotlink to their hosted images. I’m going to contact Chris Coyier and see what he says about it. Thanks!

          • Patrick Catanzariti

            All good, the issue is that it needs to be on the same server. Those images look like they’re served via a CDN which is where the problem may be :)

          • LouisLazaris

            It should work, though. If you read this post:


            You’ll notice it talks about CodePen’s CDN, and how it’s a valid origin. I’ve emailed Chris, so I’m sure he’ll look into it or let us know what we’re doing wrong. :)

          • LouisLazaris

            FYI – Response from Chris Coyier is basically that it’s either a CodePen bug or a Chrome bug, but it’s hard to tell.

            What’s interesting, as he pointed out, is the fact that it works if you refresh the demo a few times. It just seems that CodePen/Chrome don’t seem to recognize the domain as valid for the cross-origin request. @patrick_catanzariti:disqus

          • Patrick Catanzariti

            Hmmm, maybe then for now we should put in a link to for that example, just so we’ve got a working version for people looking to follow along?

          • LouisLazaris

            Yeah, you’re right. I’ll add that as a secondary link, pointing out the bug. Thanks!

  • Patrick Catanzariti

    Web dev life is getting more and more exciting with every year of advancements :D

  • Razvan Caliman

    Thank you for your thorough introduction to CSS Shapes, Patrick! You’ve done a good job at covering everything well.

    I would only point out that percentages in circle() don’t get computed from the width of the element, but with a formula from both width and height. See the spec. What you mentioned stands true as long as the host element is a perfect square, but the radius will vary for rectangles.

    Thanks for the Brackets extension shout-out! ;)

    • Patrick Catanzariti

      Thanks for the kind words Razvan! Huge thanks for clarifying the percentages in circle(), I’ll try to get that fixed up in the article.

  • 大漠

    Hi, Patrick Catanzariti ,Great Work! But i have a question.There is a place, I can not understand.
    shape-outside: circle(50%);
    shape-outside: circle(25%);
    what is the difference between them.

    • Patrick Catanzariti

      Hi! Thanks for reading and apologies for the late reply – notifications don’t seem to be working for me here! The difference between the two is circle 50% will be about half the size of the element, circle 25% will be a quarter of the size, so the text will reach further into the element.

  • Carlos Araya

    I had to add a webkit prefixed version for it to work as intended in Safari 8.

Get the latest in Front-end, once a week, for free.