igx-avatar

November 19, 2025 ยท View on GitHub

The igx-avatar component allows you to add images or initials as avatars in your application.
A walkthrough of how to get started can be found here

Usage

<igx-avatar shape="rounded" icon="person" bgColor="#0375be" data-init="SS">
</igx-avatar>

API Summary

NameTypeDescription
idstringUnique identifier of the component. If not provided it will be automatically generated.
srcstringSet the image source of the avatar.
initialsstringSet the initials of the avatar.
iconstringSet the icon of the avatar. Currently all icons from the material icon set are supported. Not applicable for initials and image avatars.
bgColorstringSet the background color of initials or icon avatars.
colorstringSet the color of initials or icon avatars. (optional)
shapebooleanSet the shape of the avatar to rounded. The default shape is square.
sizestringSet the size of the avatar to either small, medium, or large.

*You can also set all igx-avatar properties programmatically.

Examples

Using igx-avatar tag to include it into your app.

<igx-avatar icon="person" bgColor="#0375be" data-init="SS">
</igx-avatar>

Using TypeScript to modify and existing igx-avatar instance.

avatarInstance.srcImage('https://unsplash.it/60/60?image=55');
avatarInstance.size('small');