File: avatar.md | Updated: 11/15/2025
Introducing PrimeReact v11 Alpha 🥁Learn More
SearchK
10.9.7
FEATURES
API
THEMING
PASS THROUGH
Avatar represents people using icons, labels and images.
Import#
import { Avatar } from 'primereact/avatar';
import { AvatarGroup } from 'primereact/avatargroup'; //Optional for grouping
Copy
Label#
A letter Avatar is defined with the label property.
P
V
U
P
V
U
U4
<Avatar label="P" size="xlarge" />
<Avatar label="V" size="large" style={{ backgroundColor: '#2196F3', color: '#ffffff' }} />
<Avatar label="U" style={{ backgroundColor: '#9c27b0', color: '#ffffff' }} />
<Avatar label="P" size="xlarge" shape="circle" />
<Avatar label="V" size="large" style={{ backgroundColor: '#2196F3', color: '#ffffff' }} shape="circle" />
<Avatar label="U" style={{ backgroundColor: '#9c27b0', color: '#ffffff' }} shape="circle" />
<Avatar label="U" size="xlarge" className="p-overlay-badge">
<Badge value="4" />
Copy
Icon#
A font icon is displayed as an Avatar with the icon property.
4
<Avatar icon="pi pi-user" size="xlarge" />
<Avatar icon="pi pi-user" size="large" style={{ backgroundColor: '#2196F3', color: '#ffffff' }} />
<Avatar icon="pi pi-user" style={{ backgroundColor: '#9c27b0', color: '#ffffff' }} />
<Avatar icon="pi pi-user" size="xlarge" shape="circle" />
<Avatar icon="pi pi-user" size="large" style={{ backgroundColor: '#2196F3', color: '#ffffff' }} shape="circle" />
<Avatar icon="pi pi-user" style={{ backgroundColor: '#9c27b0', color: '#ffffff' }} shape="circle" />
<Avatar className="p-overlay-badge" icon="pi pi-user" size="xlarge">
<Badge value="4" />
</Avatar>
Copy
Image#
Use the image property to display an image as an Avatar.
![]()
![]()
![]()
4
<Avatar image="/images/avatar/amyelsner.png" size="xlarge" shape="circle" />
<Avatar image="/images/avatar/asiyajavayant.png" size="large" shape="circle" />
<Avatar image="/images/avatar/onyamalimba.png" shape="circle" />
<Avatar className="p-overlay-badge" image="/images/organization/walter.jpg" size="xlarge">
<Badge value="4" severity="danger" />
</Avatar>
<Avatar image={"https://www.gravatar.com/avatar/05dfd4b41340d09cae045235eb0893c3?d=mp"} className="flex align-items-center justify-content-center mr-2" size="xlarge" />
Copy
Group#
Grouping is available by wrapping multiple Avatar components inside an AvatarGroup.
![]()
![]()
![]()
![]()
![]()
+2
<AvatarGroup>
<Avatar image="/images/avatar/amyelsner.png" size="large" shape="circle" />
<Avatar image="/images/avatar/asiyajavayant.png" size="large" shape="circle" />
<Avatar image="/images/avatar/onyamalimba.png" size="large" shape="circle" />
<Avatar image="/images/avatar/ionibowcher.png" size="large" shape="circle" />
<Avatar image="/images/avatar/xuxuefeng.png" size="large" shape="circle" />
<Avatar label="+2" shape="circle" size="large"/>
</AvatarGroup>
Copy
Accessibility#
Avatar does not include any roles and attributes by default. Any attribute is passed to the root element so you may add a role like img along with aria-labelledby or aria-label to describe the component. In case avatars need to be tabbable, tabIndex can be added as well to implement custom key handlers.
Component does not include any interactive elements.
Import
Label
Icon
Image
Group
Accessibility
PrimeReact 10.9.7 by PrimeTek