---
title: Users Circle
description: A premium orbital user avatar showcase component featuring concentric dotted ring tracks, upright counter-rotating avatars, customizable radius and gap, live status indicator badges, hover tooltips, and centerpiece slot.
---

<ComponentPreview name="users-circle-demo" />

## Premium Pro Component

This is a premium Pro component. To get access to its source code and advanced interactive configurations:
1. Visit the pricing page: [https://lightswind.com/pricing](https://lightswind.com/pricing)
2. Purchase a license to unlock this component.

If you have already purchased a license, you can install this component directly via our CLI:

```bash
npx lightswind@latest add users-circle
```

*(Note: Make sure you have configured your API key in your project to authenticate your Pro license).*

## Installation

<Tabs defaultValue="cli">

<TabsList>
  <TabsTrigger value="cli">CLI</TabsTrigger>
  <TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>
<TabsContent value="cli">

```bash
npx lightswind@latest add users-circle
```

</TabsContent>

<TabsContent value="manual">

> [!IMPORTANT]
> This is a premium component. Manual copy-paste source code is only available to Pro license holders.
> Please purchase a plan at [https://lightswind.com/pricing](https://lightswind.com/pricing) to unlock manual access, or use the authenticated CLI command:
> 
> ```bash
> npx lightswind@latest add users-circle
> ```

</TabsContent>

</Tabs>

## Usage

```tsx
import { UsersCircle } from "@/components/lightswind-pro/users-circle"
```

```tsx
import { UsersCircle } from "@/components/lightswind-pro/users-circle";

export function Demo() {
  return (
    <div className="w-full h-[550px] relative flex items-center justify-center">
      <UsersCircle
        pathStyle="dotted"
        direction="clockwise"
        alternateDirection={true}
        pauseOnHover={true}
        avatarSize={52}
      />
    </div>
  );
}
```