AvatarGroup API
API reference docs for the React AvatarGroup component. Learn about the props, CSS, and other APIs of this exported module.
Demos
Import
import AvatarGroup from '@mui/material/AvatarGroup';
// or
import { AvatarGroup } from '@mui/material';
Learn about the difference by reading this guide on minimizing bundle size.
Props of the native component are also available.
Name | Type | Default | Description |
---|---|---|---|
children | node | - | The avatars to stack. |
classes | object | - | Override or extend the styles applied to the component. See CSS classes API below for more details. |
component | elementType | - | The component used for the root node. Either a string to use a HTML element or a component. |
componentsProps | { additionalAvatar?: object } | - | The extra props for the slot components. You can override the existing props or add new ones. |
max | number | 5 | Max avatars to show before +x. |
renderSurplus | func | - | custom renderer of extraAvatars Signature: function(surplus: number) => React.ReactNode
Returns: custom element to display |
slotProps | { additionalAvatar?: object, surplus?: func | object } | {} | The props used for each slot inside. |
slots | { surplus?: elementType } | {} | The components used for each slot inside. |
spacing | 'medium' | 'small' | number | 'medium' | Spacing between avatars. |
sx | Array<func | 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. |
total | number | children.length | The total number of avatars. Used for calculating the number of extra avatars. |
variant | 'circular' | 'rounded' | 'square' | string | 'circular' | The variant to use. |
Theme default props
You can use MuiAvatarGroup
to change the default props of this component with the theme.
Slot name | Class name | Default component | Description |
---|---|---|---|
surplus |
These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.
Class name | Rule name | Description |
---|---|---|
.MuiAvatarGroup-avatar | avatar | Styles applied to the avatar elements. |
.MuiAvatarGroup-root | root | Styles applied to the root element. |
You can override the style of the component using one of these customization options:
- With a global class name.
- With a rule name as part of the component's
styleOverrides
property in a custom theme.