CSS shape-margin Property
Sets a margin for a CSS shape created using shape-outside
Syntax
shape-margin: <length> | <percentage>;Values
| Value | Description |
|---|---|
| 0 | No shape margin (default) |
| <length> | Fixed margin around the shape |
| <percentage> | Percentage-based margin |
Example
.float-shape {
float: left;
shape-outside: circle(50%);
shape-margin: 1rem;
}Understanding CSS shape-margin
The CSS shape-margin property sets a margin for a CSS shape created using shape-outside. As part of the Misc module in CSS, it is one of the most commonly used properties for controlling the visual presentation of web pages.
You can set shape-margin to values such as 0, <length>, <percentage>, among others. Each value changes how the browser renders the affected element, giving you fine-grained control over your page layout and design. Choosing the right value depends on the specific design requirements of your project.
Common use cases for the shape-margin property include responsive web design, component-based layouts, and creating visually consistent interfaces across devices. It works closely with related properties like shape-outside, shape-image-threshold, float to achieve complex styling effects. Understanding how these properties interact helps you write cleaner, more maintainable stylesheets.
Browser support for shape-margin is excellent across all modern browsers including Chrome, Firefox, Safari, and Edge. For older browsers, consider using fallback values or progressive enhancement strategies. The property can also be set dynamically via JavaScript using element.style.shapeMargin or the CSS custom properties (variables) approach for theming.
Related Properties
shape-outsideDefines a shape that adjacent inline content should wrap around
shape-image-thresholdSets the alpha threshold for extracting a shape from an image used with shape-outside
floatPlaces an element along the left or right side of its container
marginSets the margin area on all four sides of an element creating space outside the border
Explore More CSS Properties
Browse our complete reference of 251 CSS properties with syntax, examples, and tips.