For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
42
Sponsor

Item

A flexible component for displaying content with media, title, description, and actions.

Basic Item

A simple item with title and description.

Your profile has been verified.
import { BadgeCheckIcon, ChevronRightIcon } from "lucide-react";

import { Button } from "@/components/ui/button";
import {
  Item,
  ItemActions,

Installation

$ pnpm dlx shadcn@latest add https://shadcn-cssinjs.com/r/item.json

Usage

import {
  Item,
  ItemActions,
  ItemContent,
  ItemDescription,
  ItemMedia,
  ItemTitle,
} from "@/components/ui/item/item";
<Item>
  <ItemMedia>
    <Icon />
  </ItemMedia>
  <ItemContent>
    <ItemTitle>Item</ItemTitle>
    <ItemDescription>Description</ItemDescription>
  </ItemContent>
  <ItemActions>
    <Button>Action</Button>
  </ItemActions>
</Item>

Composition

Use the following composition to build an Item:

Item
├── ItemMedia
├── ItemContent
│   ├── ItemTitle
│   └── ItemDescription
└── ItemActions

Variant

Use the variant prop to change the style of the item.

Default Variant

Transparent background with no border.

Outline Variant

Outlined style with a visible border.

Muted Variant

Muted background for secondary content.

import { InboxIcon } from "lucide-react";

import {
  Item,
  ItemContent,
  ItemDescription,

Size

Use the size prop to change the size of the item.

Default Size

The standard size for most use cases.

Small Size

A compact size for dense layouts.

Extra Small Size

The most compact size available.

import { InboxIcon } from "lucide-react";

import {
  Item,
  ItemContent,
  ItemDescription,

Examples

Icon

Security Alert

New login detected from unknown device.

import { ShieldAlertIcon } from "lucide-react";

import { Button } from "@/components/ui/button";
import {
  Item,
  ItemActions,

Avatar

ER
Evil Rabbit

Last seen 5 months ago

CNLRER
No Team Members

Invite your team to collaborate on this project.

import { PlusIcon } from "lucide-react";

import {
  Avatar,
  AvatarFallback,
  AvatarGroup,

Image

Group

Use the ItemGroup component to group related items together.

s
shadcn

shadcn@vercel.com

m
maxleiter

maxleiter@vercel.com

e
evilrabbit

evilrabbit@vercel.com

import { PlusIcon } from "lucide-react";

import {
  Avatar,
  AvatarFallback,
  AvatarImage,

Use the ItemHeader component to display a header above the item content.

v0-1.5-sm
v0-1.5-sm

Everyday tasks and UI generation.

v0-1.5-lg
v0-1.5-lg

Advanced thinking or reasoning.

v0-2.0-mini
v0-2.0-mini

Open Source model for everyone.

import {
  Item,
  ItemContent,
  ItemDescription,
  ItemGroup,
  ItemHeader,

Render an item as a link using the render prop.

import { ChevronRightIcon, ExternalLinkIcon } from "lucide-react";

import {
  Item,
  ItemActions,
  ItemContent,
"use client";

import { ChevronDownIcon } from "lucide-react";

import {
  Avatar,

RTL

To enable right-to-left support, see the RTL guide.

تنبيه أمني

تم اكتشاف تسجيل دخول جديد من جهاز غير معروف.

"use client";

import { ChevronLeftIcon, ShieldAlertIcon } from "lucide-react";

import { useTranslation } from "@/components/language-selector";
import type { Translations } from "@/components/language-selector";

API Reference

Item

The main component for displaying content with media, title, description, and actions.

PropTypeDefault
variant"default" | "outline" | "muted""default"
size"default" | "sm" | "xs""default"
renderReact.ReactElement-

ItemGroup

A container that groups related items together with consistent styling.

ItemSeparator

A separator between items in a group.

ItemMedia

Use ItemMedia to display media content such as icons, images, or avatars.

PropTypeDefault
variant"default" | "icon" | "image""default"

ItemContent

Wraps the title and description of the item.

ItemTitle

Displays the title of the item.

ItemDescription

Displays the description of the item.

ItemActions

Container for action buttons or other interactive elements.

ItemHeader

Displays a header above the item content.

ItemFooter

Displays a footer below the item content.