Get 50% off your order with code 𝐋𝐀𝐈𝐄𝐖 at checkout.

How to Create an Avatar Group with React and Tailwind CSS

In modern user interface design, an avatar group is a common element used to display the avatars or profile photos of multiple users. This blog post will guide you through the process of creating a stylish avatar group component using React and Tailwind CSS. We'll cover its typical use cases, provide a step-by-step guide, explain the code in detail, and explore possible extensions of the component.

Where Avatar Groups are Used

Avatar groups are commonly seen in scenarios such as:

  1. Social Media Platforms: Social media apps often display a group of user avatars in comments, posts, or chats for quick identification.

  2. Team Collaboration Tools: Collaboration tools show team member avatars on project cards or discussions to indicate responsible individuals or participants.

  3. User Profile Pages: User profile pages feature associated avatars to enhance the visual appeal of user profiles.

Step-by-Step Guide

Step 1: Setting Up the Project

Setup the project step by step from Tailwind's guide

Step 2: Creating the Avatar Group Component

Create a file named AvatarGroup.js in the src directory and add the following code:

import React from 'react'

const AvatarGroup = () => {
  return (
    <div className="flex -space-x-2 overflow-hidden">
      {/* Your avatar images go here */}

export default AvatarGroup
  • import React from 'react';: We import the React library to enable using React's features.
  • const AvatarGroup = () => { ... }: This defines a functional component named AvatarGroup using an arrow function.
  • <div className="flex -space-x-2 overflow-hidden">: This <div> element serves as the container for the avatar group. It has two Tailwind CSS classes applied:
    • flex: This class arranges elements inside the container in a horizontal row, allowing the images to be displayed side by side.
    • -space-x-2: This class, taken from Tailwind CSS, applies a negative horizontal spacing between the container's child elements. This results in a more compact arrangement of images.
    • overflow-hidden: This class ensures that any part of the child elements overflowing the container is hidden, maintaining a clean layout.

Step 3: Adding Avatar Images and Achieving the Stack Effect

In this step, we'll add avatar images to the AvatarGroup component to achieve the desired stacked effect. Here's an explanation of the code:

const AvatarGroup = () => {
  return (
    <div className="flex -space-x-2 overflow-hidden">
        className="inline-block h-10 w-10 rounded-full ring-2 ring-white"
      {/* Repeat this for each avatar */}
  • <img> Element: This is an HTML image element used to display the avatar image.
  • className Attribute: We apply a series of class names to style the image.
    • inline-block: This class makes the image display as an inline block, causing them to appear in the same line.
    • h-10 w-10: These classes set the height and width of the image to 10 units, creating a square image.
    • rounded-full: This class rounds the corners of the image, creating a circular avatar effect.
    • ring-2 ring-white: These classes apply a 2-unit wide white border around the image, creating a white border effect.
  • src Attribute: This attribute specifies the URL of the image, representing the avatar to be displayed. You can modify this attribute to display different avatars. To achieve the stacked effect, you can add multiple <img> elements inside the container. Since we applied negative spacing to the container, the images will stack more closely together, creating the desired stacking effect

Step 4: Using the Avatar Group Component

You can now use the AvatarGroup component anywhere in your application to display the avatar group. For example, in the src/App.js file, add the following code at the beginning:

mport React from 'react';
import AvatarGroup from './AvatarGroup';
import './App.css';

function App() {
  return (
    <div className="App">
      <h1>Avatar Group Example</h1>
      <AvatarGroup />

export default App;

Extending the Avatar Group

You can further extend the avatar group according to your needs. For instance, you can:

  • Fetch Dynamic Data: Retrieve user avatar data from an API and display actual user avatars in the group.
  • Adjust Styles: Customize the avatar styles such as border color, size, and more to match your design.
  • Add Interactivity: Apply hover effects or click events to avatars for users to view more information.
  • Responsive Design: Utilize Tailwind CSS breakpoint classes to ensure the avatar group maintains a good layout on various screen sizes.


By using React and Tailwind CSS, you can easily create an attractive avatar group component that can be used in various application scenarios. Customize styles and add functionality to enhance user experience based on your requirements. Start with this simple avatar group and add a touch of personality to your applications!