Lightning Component – Avatar Group

Salesforce Lightning avatar group is an element that communicates to the user that there is more than 1 person associated to an item. The Avatar Group contains two Avatar components with modifying classes. Both Avatars in the group get slds-avatar-grouped applied to them. Then, slds-avatar-grouped__primary is applied to the first Avatar and slds-avatar-grouped__secondary on the second. Avatars of the image variety are preferred within an Avatar Group.

Lightning Avatar Group – Base

Avatar Group – CSS Classes

The following table lists out the CSS classes for Lightning Avatar Group component, their usage, and the CSS selectors that these Avatar GroupCSS classes can be used on.

CSS Class NameDescription
slds-avatar-groupCreates an Avatar Group.
This CSS class can be used for the elements with CSS selector div, span only.
slds-avatar__initialsUsed for initials inside an avatar.
This CSS class can be used for the elements with CSS selector .slds-avatar abbr only.
slds-avatar__initialsUsed for initials inside an avatar.
This CSS class can be used for the elements with CSS selector .slds-avatar abbr only.
slds-avatar-groupedVariant of an Avatar in an Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-group span only.
slds-avatar-grouped_inverseVariant of an Avatar with inverse background in an Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-grouped only.
slds-avatar-grouped__primaryModifier for the primary Avatar in an Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-grouped only.
slds-avatar-grouped__initialsModifier for the Avatar that contains User Initials in an Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-grouped only.
slds-avatar-grouped__secondaryModifier for the secondary Avatar in an Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-grouped only.
slds-avatar-group_x-smallCreates an extra small Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-group only.
slds-avatar-group_smallCreates a small Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-group only.
slds-avatar-group_mediumCreates a medium Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-group only.
slds-avatar-group_largeCreates a large Avatar Group.
This CSS class can be used for the elements with CSS selector .slds-avatar-group only.

Lightning Avatar Group With User Initials

</>
Copy
<aura:component implements="force:appHostable,flexipage:availableForAllPageTypes" access="global" >
    <span class="slds-avatar-group">
        <span class="slds-avatar slds-avatar-grouped slds-avatar-grouped__primary">
            <lightning:avatar src="/docs/component-library/app/images/examples/avatar1.jpg" initials="TK" fallbackIconName="standard:person_account" alternativeText="Tutorialkart"/>
        </span>
        <span class="slds-avatar slds-avatar-grouped slds-avatar-grouped__secondary">
            <lightning:avatar src="/docs/component-library/app/images/examples/avatar1.jpg" initials="TK" fallbackIconName="standard:person_account" alternativeText="Tutorialkart"/>
    </span>
        </span>
</aura:component>
</>
Copy
<aura:application extends="force:slds">
    <c:avatargroup/>
</aura:application>

To use an image in your org as an avatar, upload the image as a static resource in the Static Resources setup page. Use the {!$Resource.logo} syntax in your src attribute, where logo is the name you provided in the Name field on the setup page. Use the alternativeText attribute to describe the avatar, such as a user’s initials or name. This description provides the value for the alt attribute in the img HTML tag.

Output

Avatar Group – Sizes

Avatar Groups come in 4 different sizes: x-small, small, medium, and large by applying a slds-avatar-group_{size} modifier class on slds-avatar-group. If the size modifier class is not used, medium is also the default size.