Skip to content

Skeleton API

API documentation for the React Skeleton component. Learn about the available props and the CSS API.

Import

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

Component name

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

Props

Props of the native component are also available.

NameTypeDefaultDescription
animation'pulse'
| 'wave'
| false
'pulse'
The animation. If false the animation effect is disabled.
childrennode
Optional children to infer width and height from.
classesobject
Override or extend the styles applied to the component. See CSS API below for more details.
componentelementType
The component used for the root node. Either a string to use a HTML element or a component.
heightnumber
| string
Height of the skeleton. Useful when you don't want to adapt the skeleton to a text element but for instance a card.
sxobject
The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.
variant'circular'
| 'rectangular'
| 'text'
| string
'text'
The type of content that will be rendered.
widthnumber
| string
Width of the skeleton. Useful when the skeleton is inside an inline element with no width of its own.

The ref is forwarded to the root element.

CSS

Rule nameGlobal classDescription
root.MuiSkeleton-rootStyles applied to the root element.
text.MuiSkeleton-textStyles applied to the root element if variant="text".
rectangular.MuiSkeleton-rectangularStyles applied to the root element if variant="rectangular".
circular.MuiSkeleton-circularStyles applied to the root element if variant="circular".
pulse.MuiSkeleton-pulseStyles applied to the root element if animation="pulse".
wave.MuiSkeleton-waveStyles applied to the root element if animation="wave".
withChildren.MuiSkeleton-withChildrenStyles applied when the component is passed children.
fitContent.MuiSkeleton-fitContentStyles applied when the component is passed children and no width.
heightAuto.MuiSkeleton-heightAutoStyles applied when the component is passed children and no height.

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

Demos