Skip to content

Masonry API

API reference docs for the React Masonry component. Learn about the props, CSS, and other APIs of this exported module.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

Import

import Masonry from '@mui/lab/Masonry';
// or
import { Masonry } from '@mui/lab';
You can learn about the difference by reading this guide on minimizing bundle size.

Component name

The name MuiMasonry can be used when providing default props or style overrides in the theme.

Props

Props of the native component are also available.

NameTypeDefaultDescription
children*node
The content of the component.
classesobject
Override or extend the styles applied to the component. See CSS API below for more details.
columnsArray<number
| string>
| number
| object
| string
4
Number of columns.
componentelementType
The component used for the root node. Either a string to use a HTML element or a component.
defaultColumnsnumber
The default number of columns of the component. This is provided for server-side rendering.
defaultHeightnumber
The default height of the component in px. This is provided for server-side rendering.
defaultSpacingnumber
The default spacing of the component. Like spacing, it is a factor of the theme's spacing. This is provided for server-side rendering.
spacingArray<number
| string>
| number
| object
| string
1
Defines the space between children. It is a factor of the theme's spacing.
sxArray<func
| object
| bool>
| func
| object
Allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.

The ref is forwarded to the root element.

CSS

Rule nameGlobal classDescription
root.MuiMasonry-rootStyles applied to the root element.

You can override the style of the component using one of these customization options: