# @vaadin/avatar-group

> vaadin-avatar-group

Latest version **25.3.5** (published 2026-10-29) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @vaadin/avatar-group
pnpm add @vaadin/avatar-group
yarn add @vaadin/avatar-group
bun add @vaadin/avatar-group
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 25.3.5 |
| Published | 2026-10-29 |
| First published | 2021-09-14 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 9 |
| Unpacked size | 70.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 583 |
| Author | Vaadin Ltd |
| Maintainers | web-padawan, platosha, jouni, manolo, yuriyyev, vaadin-owner, tomivirkki, artur-, sunzhewyq, sissbruecker |
| Keywords | Vaadin, vaadin-avatar-group, avatar-group, web-components, web-component |

## Links

- npm: https://www.npmjs.com/package/@vaadin/avatar-group
- Repository: https://github.com/vaadin/web-components
- Homepage: https://vaadin.com/components
- Issues: https://github.com/vaadin/web-components/issues
- npm.io page: https://npm.io/package/@vaadin/avatar-group

## Dependencies (9)

- [lit](https://npm.io/package/lit.md) ^3.0.0
- [@vaadin/item](https://npm.io/package/@vaadin/item.md) ~25.3.5
- [@vaadin/avatar](https://npm.io/package/@vaadin/avatar.md) ~25.3.5
- [@vaadin/overlay](https://npm.io/package/@vaadin/overlay.md) ~25.3.5
- [@vaadin/tooltip](https://npm.io/package/@vaadin/tooltip.md) ~25.3.5
- [@vaadin/a11y-base](https://npm.io/package/@vaadin/a11y-base.md) ~25.3.5
- [@open-wc/dedupe-mixin](https://npm.io/package/@open-wc/dedupe-mixin.md) ^1.3.0
- [@vaadin/component-base](https://npm.io/package/@vaadin/component-base.md) ~25.3.5
- [@vaadin/vaadin-themable-mixin](https://npm.io/package/@vaadin/vaadin-themable-mixin.md) ~25.3.5

## Alternatives

- [lodash.startswith](https://npm.io/package/lodash.startswith.md) — 769.7K weekly downloads
- [@tarojs/service](https://npm.io/package/@tarojs/service.md) — 33.9K weekly downloads
- [io.extendreality.tilia.indicators.spatialtargets.unity](https://npm.io/package/io.extendreality.tilia.indicators.spatialtargets.unity.md) — 131 weekly downloads
- [@rtarojs/taro](https://npm.io/package/@rtarojs/taro.md) — 90 weekly downloads
- [node-branch-io](https://npm.io/package/node-branch-io.md) — 50 weekly downloads

## Recent versions

- 25.3.5 (latest) — 2026-10-29
- 25.4.0-alpha5 (next) — 2026-10-30
- 25.4.0-dev.c9532cd333 (dev-table-theme) — 2026-09-30
- 25.3.0-dev.1fa5a51482 (dev-disable-dates) — 2026-07-25
- 24.4.0-dev.4b20a0c55.3 (canary) — 2024-03-22
- 24.10.10 — 2026-11-02
- 24.9.22 — 2026-11-02
- 25.2.17 — 2026-10-29
- 23.6.8 — 2026-10-29
- 24.9.21 — 2026-10-29
- 24.10.9 — 2026-10-29
- 24.4.21 — 2026-10-23
- 25.3.4 — 2026-10-22
- 25.4.0-alpha4 — 2026-10-21
- 25.2.16 — 2026-10-21
- … 668 more at https://npm.io/package/@vaadin/avatar-group/versions

## README

# @vaadin/avatar-group

A web component for grouping multiple [`<vaadin-avatar>`](https://www.npmjs.com/package/@vaadin/avatar-group) components together.

[Documentation + Live Demo ↗](https://vaadin.com/docs/latest/components/avatar/#avatar-group)

[![npm version](https://badgen.net/npm/v/@vaadin/avatar-group)](https://www.npmjs.com/package/@vaadin/avatar-group)

```html
<vaadin-avatar-group max-items-visible="3"></vaadin-avatar-group>
<script>
  document.querySelector('vaadin-avatar-group').items = [
    { name: 'Foo Bar', colorIndex: 1 },
    { colorIndex: 2 },
    { name: 'Foo Bar', colorIndex: 3 },
    { colorIndex: 4 },
  ];
</script>
```

[<img src="https://raw.githubusercontent.com/vaadin/web-components/main/packages/avatar-group/screenshot.png" width="108" alt="Screenshot of vaadin-avatar-group">](https://vaadin.com/docs/latest/components/avatar/#avatar-group)

## Installation

Install the component:

```sh
npm i @vaadin/avatar-group
```

Once installed, import the component in your application:

```js
import '@vaadin/avatar-group';
```

## Contributing

Read the [contributing guide](https://vaadin.com/docs/latest/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.

## License

Apache License 2.0

Vaadin collects usage statistics at development time to improve this product.
For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

---
_Source: https://npm.io/package/@vaadin/avatar-group · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._