Skip to content

Avatar API

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



import Avatar from '@mui/material/Avatar';
// or
import { Avatar } from '@mui/material';

Learn about the difference by reading this guide on minimizing bundle size.


Props of the native component are also available.


Used in combination with src or srcSet to provide an alt attribute for the rendered img element.


Used to render icon or text elements inside the Avatar if src is not set. This can be an element, or just a string.


Override or extend the styles applied to the component.

See CSS classes API below for more details.


The component used for the root node. Either a string to use a HTML element or a component.


Attributes applied to the img element if the component is used to display an image. It can be used to listen for the loading error event.


The sizes attribute for the img element.

slotProps{ img?: func
| object }

The props used for each slot inside.

slots{ img?: elementType }{}

The components used for each slot inside.


The src attribute for the img element.


The srcSet attribute for the img element. Use this attribute for responsive image display.

| object
| bool>
| func
| object

The system prop that allows defining system overrides as well as additional CSS styles.

See the `sx` page for more details.

| 'rounded'
| 'square'
| string

The shape of the avatar.

The ref is forwarded to the root element.

Theme default props

You can use MuiAvatar to change the default props of this component with the theme.


Slot nameClass nameDefault componentDescription
img.MuiAvatar-imgCollapseThe component that renders the transition. Follow this guide to learn more about the requirements for this component.

CSS classes

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

Class nameRule nameDescription
.MuiAvatar-circularcircularStyles applied to the root element if variant="circular".
.MuiAvatar-colorDefaultcolorDefaultStyles applied to the root element if not src or srcSet.
.MuiAvatar-fallbackfallbackStyles applied to the fallback icon
.MuiAvatar-rootrootStyles applied to the root element.
.MuiAvatar-roundedroundedStyles applied to the root element if variant="rounded".
.MuiAvatar-squaresquareStyles applied to the root element if variant="square".

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