---
title: Tag
description: A compact label for categorizing or filtering content.
---

## Preview

<ComponentPreview name="p-tag-1" />

## Installation

<CodeTabs>

<TabsList>
  <TabsTab value="cli">CLI</TabsTab>
  <TabsTab value="manual">Manual</TabsTab>
</TabsList>
<TabsPanel value="cli">

```bash
npx @olyx/cli@latest add tag
```

</TabsPanel>

<TabsPanel value="manual">

<Steps>

<Step>Install the following dependencies:</Step>

```bash
npm install @base-ui/react @hugeicons/core-free-icons @hugeicons/react
```

<Step>Copy and paste the following code into your project.</Step>

<ComponentSource name="tag" title="components/ui/tag.tsx" />

<Step>Update the import paths to match your project setup.</Step>

</Steps>

</TabsPanel>

</CodeTabs>

## Usage

```tsx
import { Tag, TagDismiss } from "@/components/ui/tag"
```

```tsx
<Tag>Label</Tag>
```

## API Reference

### Tag

Container element for the tag.

| Prop       | Type                       | Default    |
| ---------- | -------------------------- | ---------- |
| `variant`  | `"stroke" \| "lighter"`    | `"stroke"` |
| `disabled` | `boolean`                  | `false`    |

### TagDismiss

Dismiss button rendered inside a tag. Uses a built-in close icon.

## Examples

### Lighter

<ComponentPreview name="p-tag-2" />

### Dismissible

<ComponentPreview name="p-tag-3" />

### Disabled

<ComponentPreview name="p-tag-4" />

### With Icon

<ComponentPreview name="p-tag-5" />