---
title: "Mention Chip"
description: "An inline chip for user, channel, role and app mentions, with an optional avatar."
---

An inline chip for user, channel, role and app mentions, with an optional avatar. Compose it from the exported registry parts so local content and behaviour stay in the application while the visual contract stays token-driven.

_Live example of Mention Chip — see the page for the rendered demo._

## Installation

```bash
npx newtui@latest add mention
```

npm dependencies: class-variance-authority.

Files written — React: components/ui/mention.tsx. Vue: components/ui/mention/Mention.vue, components/ui/mention/index.ts.

## Usage

React:

```tsx
import { Mention } from "@/components/ui/mention"
```

Vue:

```ts
import { Mention } from "@/components/ui/mention"
```

## API reference

**`Mention`**

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `avatar` | `string \| undefined` | — | Avatar URL. Rendered from 48rem up; below that the chip stays text-only. |
| `color` | `string \| undefined` | — | Role colour, for `variant="role"`. Any CSS colour. |

The registry exports `Mention`. Parts without a table accept the native attributes for the element they render; React uses `className`, while Vue uses `class` and fallthrough attributes.

## Accessibility

Preserve the native semantics of the rendered elements and pass through ARIA attributes when the surrounding context needs a label or description. Any interactive child needs a visible focus indicator, and meaning must not rely on colour alone.

## Tokens

Mention Chip reads its colours, radii and motion from the `--newt-*` tokens. Override a token rather than editing the component.